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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


WELCOME TO 
THE OFFICIAL 
MAGAZINE 


t’s a project that has captured the hearts 
and minds of enthusiasts throughout 
the Raspberry Pi community: the magic 
mirror. A wonderful, useful piece of home 
automation straight out of Tony Stark’s house 
that you can build with a Raspberry Pi, an old 
monitor, and some wood. 

We’ve wanted to do a magic mirror tutorial 
in the magazine for quite some time, so it was SEE PAGE 26 FOR DETAILS 
a delight that one of the driving forces behind 
it, Michael Teeuw, agreed to help us create the 
definitive guide to powering up your home. 

If home automation isn’t your thing, we have THIS MONTH: 
some great coding projects this issue, such as 
more from Simon Long on coding with C, the 
conclusion of our multi-booting guide, and the 
continuation of Lucy Hattersley’s beginner’s 
coding guide with a look at object-oriented 
programming. As for me, among other things I’ve 28 A MUSEUM IN A BOx 

; Learning has never been so fun 
reviewed a robot. | like robots; they’re fun. Take a 
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Our bumper guide to conquering the command line 


> BUILD AN EMOTIONAL ROBOT 44 


Create an empathetic automaton that reacts to people 


> NIGHT-TIME WILDLIFE PHOTOS 46 


Use a Pi NoIR to make an outdoor IR nature camera 


> INTRODUCTION TO C PART 8 00 


Master string libraries to simplify your code 


> CREATE A DRUM MACHINE 02 


Tap Pringles cans to make a beat in the Pi Bakery 


> MULTI-BOOT YOUR PIPART2 58 


Add multiple operating systems to your Raspberry Pi 


> CREATE SOUNDS IN SONIC PI 60 } | } | 
Combine sounds together to make whole new ones ACs | C | R R () R 


ONLINE TRAINING 


Celebrate the Pi's fifth 
Free online learning resources available birthday this March 


4 | MagPi February 2017 raspberrypi.org/magpi 


THE BIG FEATURE 


LEARN MORE CODE 


Following on from last issue's coding guide, learn more 


about Python and other object-oriented programming 


MUSEUM IN A BOX 


Portable and small museum exhibits that fit in a box 


NASA BCSI 32 


A shoe fit for an astronaut 


How one maker created a bipedal Pi robot 
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ANNOUNCES 
ONLINE TRAINING 


Learn to teach programming and physical 
computing with free Raspberry Pi courses 
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Both courses are free. You can buy a Certificate 
of Achievement for this course - a personalised 
certificate and transcript in digital and printed 


formats - to prove what you've learnt (£59). A 
Statement of Participation (£34) is also available. 
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he Raspberry Pi Foundation 

has launched two new 

online courses designed to 
enable educators around the world 
to learn how to teach computing 
with a Raspberry Pi. 

“We hope they will inspire a 
new army of enthusiastic makers 
around the world,” says Lauren 
Hyams, online training manager. 

The two offerings are Teaching 
Programming in Primary Schools, 
and Teaching Physical Computing 
with Raspberry Pi and Python. 

Both courses are available via 
FutureLearn (magpi.cc/2h5Sthf). 
The courses are completely free. 
A printed certificate, to prove 
that learners have completed the 
course, is available for a small fee. 

Each course is designed to last 
four weeks. There are around two 


pte Pays ie 


hours of materials for learners to 
work through each week. “It’s fine 
to take more time to reflect and 
learn at your own pace, though,” 
Lauren tells us. “Courses begin on 
20 February 2017, and you can sign 
up for both of them right now.” 

The two courses will be repeated 
later In 2017. 


Global learning 

The Raspberry Pi Foundation has 
trained over 540 educators in the 
US and the UK this year, “which 
we’re immensely proud of,” 
remarks Lauren. 

However, this model of face-to- 
face training has its limitations. 
“We often get questions like ‘Why 
haven’t you run a Picademy near 
me yet°’ and ‘When are you coming 
to train us°’.” 
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The Raspberry PI Foundation 
erew frustrated at having to tell 
people that it didn’t have plans to 
provide a Picademy in their region 
in the foreseeable future. So, it has 
developed these courses as a way to 
reach educators around the world. 


Courses begin on 20 February | 
2017, and you can sign up for 
both of them right now 


Everybody is welcome 
“This new free training supports 
our commitment to the White 
House’s Computer Science For All 
initiative,” says Lauren. 
Everybody is welcome to sign 
up for the two courses. However, 
both courses are designed with 
particular educators in mind. 
Teaching Programming in Primary 
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COURSES 
| FOR TEACHERS 


Professional educators will guide 
teachers around the world in teaching 
coding and physical computing 


The Raspberry Pi Foundation is 
offering two online courses 


TEACHING PHYSICAL COMPUTING 
WITH RASPBERRY PI AND PYTHON 


Start Date: 20 February Duration: four weeks 


Time: two hours per week | magpi.cc/2iH8GtD 


This four-week course will introduce you to physical 
computing, showing you how easy it is to create a 
“system that responds to and controls the physical world, 
| using computer programs running on the Raspberry Pi. 
You'll apply your newfound knowledge to a series of 
challenges, including controlling an LED with Python, 
using a button press to control a circuit, and making a 
Schools was designed for non- 
subject-specialist primary or K-5 
teachers. “You don’t need any 
prior experience of programming 
to take part,” confirms Lauren. 
Teaching Physical Computing 


button and LED game. 
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with Raspberry Pi and Python " 
J ~S.., 


TEACHING PROGRAMMING IN PRIMARY SCHOOLS 


Start Date: 20 February Duration: four weeks 


was designed for anyone 
interested in digital making. 

“Tt will be of particular use 

to teachers who are note subject 
Specialists, computing teachers, 
and design and technology 
teachers who are interested 

in using the Raspberry Pi and 
Python in their classroom,” 
explains Lauren. 


Time: two hours per week | magpi.cc/2jx6Xul 


This four-week course will provide a comprehensive 
introduction to programming and is designed for 
primary or K-5 teachers who are not subject specialists. 
You'll have the chance to apply your understanding of 
the concepts through projects, both unplugged and 

on acomputer, using Scratch as the programming 
language. Discover common mistakes and pitfalls, 

and develop strategies to fix them. 
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COMPUTE 


MODULE 3 


New model based on Pi 3 is ten times more powerful 


he Raspberry Pi 

Foundation has launched 

a new version of its 
Compute Module — a Raspberry 
Pi in a more flexible form factor, 
intended to provide an easy and 
cost-effective route to producing 
customised products. While 
the original Compute Module, 
launched in 2014, contained the 
euts of a first-generation Pi, the 
new Compute Module 3 (CM3) 
is based on the Pi 3, so offers a 
major boost in performance. 

“It’s got the same BCM2837 

processor which can run at up to 
1.2HGz, and 1GB of RAM,” says 
Foundation COO James Adams. 
This means it provides twice the 


The Compute Module 3 will be 
used in NEC’s new range of smart, 
large-format displays 
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RAM and roughly ten times the 
CPU performance of the original 
Compute Module (CM1). Just like 
the Pi 3, the CM3 is able to run 
Windows 10 IoT Core, opening 
up many possibilities: “An IoT 
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“Some users wanted free access 
to add their own flash [storage],” 
explains James. To solve this, two 
versions of the CM3 are being 
released: one with 4GB eMMC on 
board and a ‘Lite’ model which 


Based on the Raspberry P1 3, 
it offers a major boost in 


performance 


project can be ported from a Pi 3 
onto a custom CM3-based system 
very easily.” 

One issue with the CM1 was the 
fixed 4GB of eMMC flash storage: 


requires the user to add their own 
SD card socket or eMMC flash. 
“We expect this version to be 
quite popular.” 


A quick upgrade 

With a few caveats, the CM3 can 
be used a drop-in replacement 
for the CM1 since they are pin- 
compatible; the CM3 is 1mm 
taller, however, while the CPU 
can pull a lot more current from 
the VBAT power supply line 

and will generate far more heat 
under heavy load. 

The Compute Module 3 and 
CM3 Lite are priced at $30 and $25 
respectively (excluding tax and 
shipping), while the CM1 (which 
isn’t being made obsolete) is $25. 
An updated IO breakout board 
(CMIO3) has also been launched, 
which will accept all three models. 


raspberrypi.org/magpi 


»* * 


.. CREATION — 
_MADEEASY . 


A complete kit to expand your universe. 
WD PIDRIVE' Kit Includes: Black Square 6"x6" Enclosure Top and Bottom 


WD PiDrive Foundation Edition 375GB WD PiDrive Cable 


COM PUTE CE NTRE Raspberry Pi 3 Power Supply and USB cable 


Wireless Keyboard & Mouse MicroSD™ card (with preloaded software) 


Me 


$109°%° 


pin 


PRELOADED WITH ORGANIZE PROJECTS EASY TO ASSEMBLE 
STARTER SOFTWARE IN A SINGLE PLACE WITH EVERYTHING 
YOU NEED 


Start creating right away with our custom The included Project Spaces software 
NOOBS OS Installer, Raspbian PIXEL, and lets you create up to five work spaces to Using a custom 6x6 enclosure to house a 
Raspbian Lite, boot from the included microSD organize, access, and customize your Raspberry Pi and WD PiDrive side by 
card and launch operating systems directly projects in just one Raspberry Pi and side, the WD PiDrive Compute Centre 
onto the USB drive. hard drive setup. 


keeps your components in a tidy, 
attractive unit. 


Q 


Western Digital; WD; the WD logo, WDiLsbs and the WDLabs logocare registered trademarks or trademarks of Western Digital Corporation:or its affiliates in the U.S: and/or other countries, Raspberry Pi.is a trademark of the Raspberry Pi Foundation, microSD is‘a trademark of 
SD-3C, LLG. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating environment. Product specifications subject to change without notice. Pictures 
shown may vary from actual product, © 2017 Western Digital Corporation or its affiliates 


KOSOs as WA 


The Young 
Innovators is a 
robotics club 
based in Shtime, 
southern Kosovo 


The robots 

built by Young 
Innovators, ready to 
do battle in Pi Wars 


Young makers in troubled country learn to build robots 


any of us will know of 
Kosovo due to the war that 
took place there in 1998-9. 

However, young makers in 
this country are putting that real 
war behind them by running 
the country’s first ever Pi Wars 
(magpi.cc/2iHC4QK)). 

“We declared independence 
from Serbia just eight years ago,” 
says Andy Moxon. Despite living in 
difficult times, “the country is not 
without Python coding, physical 
computing, robots, and a good 
number of Raspberry Pi computers.’ 
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Andy has been running an 
after-school club called Young 
Innovators (magpi.cc/2iHAtuc), 
based in the small town of Shtime in 
southern Kosovo. 

“The club aims to bring maths and 
physics to life, while also teaching 
the students programming and 
robotics,” explains Andy. 


One area which has caused a 
lot of excitement in the club has 
been the recent introduction 
of an Ultimaker 2+ 3D printer 
(magpi.cc/2iHC5Eg). “Using 
FreeCAD, we have designed the 
chassis of the robots from nothing,” 
reveals Andy. “This has been a 
tough but worthwhile exercise, 


Big thanks must go out to the 
Raspberry P1 community 


“Our robots are pretty standard,” 
he adds. A Pi Zero is powered bya 
thin mobile phone power bank. Each 
robot has two motors controlled by 
an L293D motor controller chip. Also 
included are ultrasonic distance and 
infrared line sensors. 

“We use two additional infrared 
sensors to count wheel revolutions,” 
says Andy, “having painted 
white stripes on our wheels using 
nail polish.” The sensors open 
the robots up to some interesting 
autonomous challenges. 


demonstrating the wonders of 
3D prototyping.” 

The robots took part in the 
country’s first Pi Wars battle in 
December. The event was even 
covered by TemaTV, a regional 
television station. 

“Big thanks must go to the 
Raspberry Pi community,” says 
Andy. “I first used a Raspberry Pi 
just a year ago and without the 
dedication of excellent bloggers, 
we would never have been able to 
reach this stage.” 
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GAME FORALAUGH ‘News 


GAME NOW TRENDING 
FORA 


Fi PROJECTS 2 ON AMAZON 


magpi.cc/2hrrb7r 
Pioneers programme launches by challenging 
teenagers to make the Foundation laugh 


™ Official 


RASPBERR 
PROJECTS Boon 


VOLUME 2 


News that The Official Raspberry Pi 
Projects Book 2 had gone on sale 
at Amazon went wild on Facebook 
during December. We think it 
makes a great present all year 
round, but hope lots of you were 
happy to find it under a tree. 


he Raspberry Pi Foundation to form teams and build something : 
'w) Pt 
es 


has officially launched its that’1l make other teens laugh. | ¢ 
Pioneers programme for These projects are then shared so q PloNeERs 
teens with a challenge to make online to earn the kudos and | | 
everyone laugh. respect of other young makers. 
From electric shock buzzers They'll also win money-can’t-buy 
to voice modulators and dancing prizes and cool swag. 
robots, there’s lots of fun to be “We want to find and support 
found in Raspberry Pi. teenage digital makers in the A 
There’s a long tradition of UK,” says Rob Buckland, director DEBIAN + PIXEL 
creating pranks in electronic of programmes. “The aim of 
circles. MIT students once hacked _— Pioneers is to provide guidance, magpi.cc/2hgmiyY 
the lights in their tower block to inspiration, and mentorship to News about Debian + PIXEL set Google Plus on 
create a giant game of Tetris they teenage makers, and to the adults fire last month. In case you missed the free DVD 
could play outside the building. who mentor them.” on last month's magazine, you can download the 
Teenagers between the ages of Take a look at magpi.cc/2iHKIP5 Raspbian + PIXEL ISO direct from the Raspberry Pi 
twelve and 15 are being challenged for more information. website (magpi.cc/2iBsgeO). 


Teenagers are being challenged 
to make everybody laugh with 
the Pioneers programme 


oe! 


CEMENT THWOMP 


magpi.cc/2gPJiRY 


Made from real cement, this incredible case has a 
Raspberry Pi inside. A custom mould is used to cast 
the concrete into the shape of a character from Super 
Mario 3D. A big, big hit on Twitter. 
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Raspberry Pi 
Foundation CEO 
Philip Colligan 
hosting a workshop 
lecture at last year's 
Big Birthday Party 


he Raspberry Pi Foundation 
has announced plans for 
its Big Birthday Weekend 

party in 2017. 

Taking place from Saturday 

4, March to Sunday 5 March, the 

Big Birthday Weekend a two-day 

event when the whole community 


Cambridge Junction 


Cambridge Junction, Clifton Way, Cambridge, CB1 7GX 
Saturday 4 March 2017: 10.30am-6.30pm 
Sunday 5 March 2017: 10am-5.30pm 


Tickets: £5 (16 years and over), free (under 16) 
Ticket purchase available here: magpi.cc/2iIHMAax 
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meets up with the Raspberry Pi 
Foundation team. 

“Our annual birthday weekend 
is always great fun for families, 
hobbyists, and educators,” says 
Helen Drury, outreach and events 
manager, “as well as our team of 
amazing community volunteers. 


ZO1/ 


Raspberry Pi Foundation set to throw a massive party for its fifth year 


we’re doing to support educators 
teaching computer science.” 

The party will feature talks and 
workshops covering multiple 
subjects and interests. Show-and- 
tell stands will showcase incredible 
creations, while vendors exhibit 
their kits in the Maker Market. 


Goody bags and cupcakes 
throughout the weekend 


“This year it’s going to be bigger 
and better than ever.” 

The two-day event will be 
taking place at Cambridge 
Junction, the leading arts centre 
in Cambridge. Tickets are £5 if you 
are aged 16 or over. Entrance is free 
for under-16s. 

“Raspberry Pi and Code Club will 
be both turning five,” reads the 
invitation. “We'd love for you to 
come and see what Raspberry Pi 
is all about, try some of our Code 
Club projects, and learn what 


There will also be goody bags and 
cupcakes throughout the weekend. 
The full programme will be 
available shortly. Workshops will be 
registration-only, and you can sign 
up for them when they launch. 
There are lots of ways you can 
get involved with the Big Birthday 
Weekend (beyond just turning up). 
In the meantime, if you haven’t 
been to a Raspberry Pi party 
before, check out the Raspberry 
Pi Foundation blog from last year: 
magpi.cc/2cBFJyo. 
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IN THE HOUSE 


Home of the future powered by Raspberry Pi 


uturehome is a self- Indiegogo campaign, Futurehome 
adjusting home automation has started production. The 
kit with the Raspberry Pi units are reportedly selling in 
Compute Module at its heart. their thousands. These open standards allow for ei eoroile with 
“Futurehome lets you control, It’s a good example of what hundreds of different types of Module, the 
automate and monitor your home entrepreneurial makers cancreate gadgets to be controlled, covering shed ot 
from anywhere in the world,” with a Raspberry Pi. everything from lighting to heating —_ automation product 
and motion sensors. 
Automate and monitor your At the heart of the device is the 
Smarthub containing a Raspberry 
Pi Compute Module. Futurehome 
home from anywhere has also created an iPhone and 
Android app to control the system. 
says Odd Eivind Evensen, product The Smarthub works like an “The small form factor and the 
development manager. internet router, but for smart power of the Raspberry Pi [Compute 
The company sells a Smarthub devices. It “communicates Module], not to mention the eMMC 
(magpi.cc/2hRxxOL) for NOK 2499 _ through the open standards memory, all makes it the perfect 
(£233/S359). Following a successful Z-Wave and EnOcean.” server,” the firm tells us. 


TAKING THE RASPBERRY PI TO THE NEXT LEVEL 


FIPS Y GIPSY 


HOME INTRUSION PREVENTION SYSTEM GLOBAL INTRUSION PREVENTION SYSTEM 


MANAGED CYBER-PROTECTION SERVICE 


TRAVEL 
CYBER | ANYTIME, 
SHIELD ANYPLACE 


DEVELOPED BY THE INDUSTRY EXPERTS 


appcom 


LINUX OPERATING SYSTEM + INDUSTRY STANDARD INTRUSION DETECTION ENGINE + SMALL WEB SERVER « DNS SERVER * NETWORK SCANNER 
ENHANCED WIRELESS FUNCTIONS +- CLOUD BASED MANAGEMENT VPN « IDAPPCOM RULES MANAGEMENT SYSTEM 
ACCESS TO 10,000 PLUS EXPLOIT RULES * OPTIONAL MALWARE AND PHISHING PROTECTION 


PROTECT YOUR FAMILY, FINANCES & FILES AT HOME & ON THE GO Our products are built on the best of British small computer, using 


our decades of expert security experience. We provide 24 hour 


security management via the cloud connected Idappcom 
Security Operations Centre. 

SHIELD FROM EXPLOITS = PROTECT FROM PHISHING BLOCK MALWARE Taking the Raspberry Pi to the Next Level of Cyber Protection 

Attackers working from Invitations to reveal your Attacks that have been Visit: ipssecurityrules.com Call: +44 (0) 203 355 6804 


outside your system private information installed inside your system 


feature 


BUILD YOUR OWN. 


Live in the future with your own internet-connected mirror straight from science-fiction 


e live in a world where more and more items off so well in the maker community - getting all the 

are becoming part of the Internet of Things. information you need at a glance while checking your 

Fridges sending an email about buying some appearance before you leave the house. It’s passive 
more milk. Washing machines tweeting you when and useful. Michael Teeuw pioneered the concept on 
they’re done. An app on your phone that lets you turn the Raspberry Pi, making it easy enough for everyone 
ona light. A lot of this seems gimmicky, though, which to make one. All you need to build your own is a bit of 
is probably why the magic mirror concept has taken Spare time and a trusty saw. 
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feature 


GET ALL 
THE SOFTWARE 
AND INFO YOU 
NEED ONLINE AT: 


The code for the mirror is all 
there and ready to be installed 
with one line 


Used in the right way, you can 
make an info-laden mirror 


Get out your tape measure and 
put a pencil behind your ear 


iguration options 


The following properties can be configured 
removeStartlags: false, removeEnd Tags: false, startTags: [], endTags: [] 
Option Description 
An array of feed urls that will be used as source 


More info about this object can be found below. 


feeds 
Default value: [{ { title: "New York Times", url: 
http: //www.nytimes.com/services/xnl/rss/nyt/HomePage.xml", encoding: "“UTF-8" } } 
Display the title of the source 

sho r 


Possible values: true or false 
Default value: trur 


How often does the content needs to be fetched? (Milliseconds 
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feature 


What you need to 
build your mirror 


Plywood is a good option for 

this. If you're a little more skilled 
at carpentry, however, you can 
have a look at pine or another 
material. Make sure it’s sturdy and 
deep enough to contain all the 
electronics when built - havea 
look at our build steps for an idea 
of the size in comparison. 


You'll want to make your frame 
look good, so get some filler to 
help smooth it out, and some 
wood paint to finish it off. If you like 
the wood you've used, get some 
varnish instead. 


February 2017 


The fascia can be made from skirting 
board or moulding - make sure it’s wider 
than the wood you plan on using for the 
frame so it can keep everything in place. 


We'll use these to attach the front 
of the frame; 15-20mm should do. 


P| 
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Asmall selection of wood screws to 

build the frame. They don't need to be 

__» huge, though: about 20mm longer than 
"the depth of the wood should be fine. 


WOOD 
GLUE 


== Buy one the same size as the 
We're using this to make sure everything monitor, which will also be the 
stays together as intended. Think of it as same size as your frame. You can 
a backup for the screws. get some made from acrylic. 
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BUILD YOUR OWN MAGIC MIRROR 
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You'll need one to power the TV, of 
course. A case (and a WiFi dongle if 
you're using a Pi 2) should help make 
things a little more tidy and secure. 
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You'll need a saw, a hammer, 
a drill, some clamps, and 
various painting tools to do 
this. Research what you'll 
need for specific bits. 
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Measure the dimensions of the monitor. It may be 
an idea to see how deep it is as well, to ensure your 
wood selection is correct; it’s best to have a little 
space between the back of the monitor and the 
wall, so make sure your wood will allow for this. 


7 TT 


As this is the main frame, it’s best to have this as 
sturdy as possible. Screwing the wood into place 
with two screws will Keep it nice and strong, but 
adding a little wood glue will make sure it stays 
together even better. 


February 2017 


The basic frame is made up of 
four pieces of wood. You can 
view it as two Side pieces and 

a top and bottom piece. The 
sides should be slightly longer 
as the mirror will be in portrait 
orientation. The sides should 
be the same length as the long 
edges of the monitor, while the 
top and bottom should be the 
length of the short sides plus 
the width of the wood pieces 

so that they can fit neatly on 
top as arectangle. Make sure 
to not make the fit too snug for 
the monitor — allow for an extra 
millimetre or two. 


Width of monitor 
+ depth of wood « 2 


Height of monitor 
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With the main frame done, we can now add the front 
of the frame. This has two functions: it covers the 
bezel on the monitor, making it look a bit better 
aesthetically, and acts as a lip to hold the monitor and 
mirror in place. Make sure the material is deeper than 
the wood for the frame to make this lip, and cut the 
ends at an angle for when you join them all together. 


Carefully nail on the front pieces, making 
sure they’re flush to the edge of the outside. 
Do one nail at each end first to make sure it is 
orientated correctly (don’t nail it in fully until 
you’re sure), or use a vice lightly gripping it 
all together. Once you’ve done a couple of the 
pieces, the other two will be easier to get right. 
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Drill a few holes through the top and bottom parts 
of the frame, as shown - this aids ventilation. 
Nothing should be getting toasty hot in there, but 
it’s better to have some air going through. You’ll 
also need a piece, as shown, with some slots to 
hang over screws in the wall. You should make a 
little indentation on the back of the bottom piece 
of wood so the power cables can run through to 
the monitor and Pi. Finally, create some small 
brackets that you can fasten to the frame to keep 
the monitor from falling out of the back. 


February 2017 


Use a little filler to cover any dents, as well as the nail 
heads on the front of the frame. Give it a sand as well, 
to smooth everything off and prepare for painting. 


In this example, the frame has been painted white with 
some wood paint. Make sure to do this in a well-ventilated room. 
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~ 
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When the paint is dry, flip the frame over so it’s 
resting on its front and carefully lower the mirror 
in. We’re going to keep it in place using the 
overhang of the front moulding and the monitor, 
effectively sandwiching it between them. 


This bit is pretty easy: just put the monitor into the One thing the more advanced maker could do is combine the 
back, fasten it in with the little wooden brackets, power cable to the TV with a plug-to-USB adapter. This way you 
and hook up the Raspberry Pi tothe HDMI. Run only need one cable running through to the mirror. 


power cables through the indentation you made. 


eeceeeeeeeeoeoeoeeoeeoeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee7e7eeee7eee7eeeeeeeeeeeeeeeeeeee eee eee eee eee eee ee et 
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PROGRAM YOUR 


MIRROR 


Install the software to your Raspberry Pi and make your mirror truly magical 


nce you’ve hung your mirror on the wall, or 

placed it wherever it’s now going to live, it’s 

time to install the software. Michael has made 
the process incredible easy, and all you need to do is 
type the following command: 


curl -sL http://magpi.cc/MirrorInstall | bash 


It will go through the installation process and set up 
some defaults... and that’s it! Your mirror is ready to use. 


PERSONALISATION 


Well, almost ready: you may want to have a quick 
look at editing those default values to make sure it’s 
running as you’d like it to. The settings are kept ina 
config file which you can create by using: 


cp ~/MagicMirror/config/config.js.sample ~/ 
MagicMirror/config/config.js 


You can now access and modify it with: 
nano ~/MagicMirror/config/config.js 


Here are some of the options you can modify... 


The sample configuration file gets you 
started, but there's way more you can do 
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OPTION 


port 


address 


ipWhitelist 


zoom 


language 


timeFormat 


units 


modules 


electronOptions 


DESCRIPTION 


The port on which the MagicMirror server will run 
on. The default value is 8080. 


The IP address of the mirror you use to connect to it. 


The list of IPs which are allowed to connect to 
the mirror. The default value is ["127.0.0.1", 
we CTTT?i127.0.0;4."5 "22" | 1 1s 

possible to specify IPs with subnet masks 
({"127.0.0.1", "127.0.0.1/24"]) or define 
IP ranges (("127.0.0.1", ["192.168.0.1", 
"192.168.0.100"]]). 


This allows scaling of the mirror interface witha 
given zoom factor. The default value is 1.0. 


The language of the interface. Possible values are 
en, nl, ru, fr, and so on, but the default value is en. 


The style of clock to use. The accepted values are 
12 and 24. The default is 24. ) 
The units that will be used in the default weather 
modules. Possible values are metric or imperial. 
The default is metric. 


An array of active modules. There must always be 
an object in here. 


An optional array of Electron (browser) options. 
This allows configuration of e.g. the browser screen 
size and position (defaults .width = 80@ and 
-height = 6@@). Kiosk mode can be enabled by 
setting .kiosk = true, .autoHideMenuBar = 
false, .fullscreen = false. 
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CUSTOMISING YOUR 


MIRROR 


Make your mirror truly yours by adding and customising modules 


OPTION 


S well as the pre-installed default modules, 
you can add third-party modules that have 
either been created by the community 

or yourself. They’ re easy to add: you just need to 
download the files and then update the configuration 
file to use them. 

First of all, take a look on the page for the 
MagicMirror modules in the GitHub repo here: 
magpi.cc/2iqWPUh. You’|I find a list of great modules 
to add, such as a Bitcoin monitor and something that 
displays today’s XKCD comic. Pick one you like and 
copy the link location to it. 

To install the module, first move to the modules | 
folder with cd~/MagicMirror/modules and then og 
download the data for it with: a 


module 


position 


Sg acm Rina 


Ew 00005055855 t tec c esses esses ssccccccees 


git clone https://github.com/[author]/ -3 
[module -name] ag 


om 0 OCcass 33 
a the pj INSide 33 


‘°° Oa 


...with the GitHub link pasted from the link you 
copied. Check out the readme for the module and see © Ba 
if there are any other steps to perform, otherwise . 
open up the config.js file from before and add the 

module to the module section. You’1l need to format it 
something like: 


header 
{ 
module: ‘module name’, 
position: ‘position’, 
header: ‘optional header’, 
config: { 
extra option: ‘value’ 
} 
}, 


disabled 


config 


Here’s the full list of options to use... 


24 


acetee 


McdgPi February 2017 e 


DESCRIPTION 


The name of the module. This can also contain the 
subfolder. Valid examples include clock, default/ 
calendar, and modules/[module name]. 


The location of the module on the mirror. 
Possible values are: 


top_bar, top_left, top center, 

top right, upper_third, middle_center, 
lower_third, bottom_left, bottom_center, 
bottom right, bottom bar, 
fullscreen_above, and fullscreen_below. 


©}. This field is optional, but most modules require 
it to be set. Check the documentation of the 
~ module for more information. Multiple modules 


with the same position will be arranged based 
on the order in the configuration file. Some trial 
and error is required. 


Additional classes which are passed to the 
module. The field is optional. 


To display a header text above the module, add 
the header property. This field is optional. 


Set disabled to true to skip creating the module. 
This field is optional. 


An object with the module configuration 
properties. Check the documentation of the 
module for more information. This field 

is optional, unless the module requires 
extra configuration. 


SUPPORT & 
COMMUNITY 


You’ve made your mirror, now 
here are some ways to keep up on 
its developments 


MAGICMIRROR SITE 


magicmirror.builders 


eeccccccce 


Your first stop for MagicMirror info is the home site 
for the software. You’ll find some handy links, such 
as those to the blog for updates on the project, GitHub 
for the source code and more in-depth configuration 
options for the mirror, as well as a link to the forum 
and available modules. It’s also a good way to quickly 
introduce a friend to the concept. 
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MAGICMIRROR FORUMS 
magpi.cc/2je2dXI 


The community for the MagicMirror lives here, and 
the answer to many problems you might face in the 
long term have likely already been answered there. 
They’re a friendly bunch, though, so if you can’t find a 
solution, you can always have a chat with them to find 
out what might be going wrong. You’1l also be able to 
compare notes about any modules you decide to make 
or any other little upgrades or building tips you might 
want to know about. 
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MAGICMIRROR MODULE 
DEVELOPMENT DOCUMENTATION 


mMagpi.cc/2jebFux 


All modules are loaded in the modules folder. The default modules are grouped together in the modules/default folder. Your 


BUILD YOUR OWN MAGIC MIRROR 
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MagicMirror* Module Development Documentation 


This document describes the way to develop your own MagicMirror* modules. 


Module structure 


feature 


MagicMirror? 


The open source modular smart mirror platform, 


licerme MI build passing 9 vulneralzities | 0 


deperviercics Upto date 
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module should be placed in a subfolder of modules . Note that any file or folder your create in the modules folder will be 


Fancy making your own custom module for your 
mirror? You’1l need to know how the API and code 
generally works, and you can do that with the 
documentation provided on the MagicMirror GitHub 
repo. We’ve seen some excellent add-ons for the 
mirror code, including seasonal variations and live 
train times. All you need is a way to get the data! 


te Ath aad lid ded 


ignored by git, allowing you to upgrade the MagicMirror® without the loss of your files. 


A module can be placed in one single folder. Or multiple modules can be grouped in a subfolder. Note that name of the 
module must be unique. Even when a module with a similar name is placed in a different folder, they can't be loaded at the 
same time 


Files 


modulename/modulename.js - This is your core module script. 

modulename/node_helper.js - This is an optional helper that will be loaded by the node script. The node helper and 
module script can communicate with each other using an intergrated socket system. 

modulename/public - Any files in this folder can be accesed via the browser on /modulename/filename.ext . 
modulename/anyfileorfolder Any other file or folder in the module folder can be used by the core module script. For 
example: modulename/css/modulename.css would be a good path for your additional module styles. 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today and receive: 
A free Pi Zero v1.3 (the latest model) 
A free Camera Module connector 
A free USB and HDMI cable bundle 


Delivered with your first issue! 
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Save up to 25% on the price 


, 7.4 oS eR 
SN Free delivery to your door 
Exclusive Pi offers and discounts 
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» Started as an 
R&D project by 
Good, Form & 
Spectacle 


» The team 
are based in 
London and 
Liverpool 


» The first box 
was built at 
Somerset 
House 


» All the original 
pieces were 
scans from the 
British Museum 


» The company 
incorporated in 
October 2015 


The Raspberry Pi, along 


with the RFID reader, acts 
as the ‘brain’ of the box 


Each object is fitted with 
an RFID tag, preset to play 
back relevant content 


3D-printed objects allow 
us to bridge the ‘do not 
touch’ gap with ease 


Museum in a Box gives us the chance to experience incredible pieces of 
art, artefacts, music, and more at our fingertips, anywhere in the world 


ou can visit Hoa regarding both his own history and your palm and allows you to feel 

Hakananai’a at the British that of his fellow Moai and it’s fair the texture of his surface and the 

Museum, London. A Moai, to say that, unless you can go to the shape of his features. You can pass 
you’d likely recognise him as one British Museum in person, you’re him around, reposition him, and 
of the Easter Island statues. He’s unlikely to see him visiting your local even drop him if you lose your 
2.4 metres in height, nearly a metre museum, school, or library on loan. erip. And as you ‘boop’ him on 
wide, and is estimated to weigh Now imagine holding a smaller the top of the Museum in a Box’s 
around four tonnes. He sits ona version of Hoa Hakananai’a in Raspberry Pi-powered ‘brain’, he 
high plinth surrounded by text your hand. He fits perfectly on Starts to tell you the story of his 
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Shrunken models of 
famous ‘giants’ allow for 
greater access to pieces 
across the globe 


sea voyage from Easter Island, of get to grips with a history they may 
the history of his creators,andhis otherwise miss out on. 
first encounter with the explorer On the technical side of the 
Captain Cook in 1774. project, the Museum in a Box 
consists of a wooden box ‘brain’ 
Bonding with history that houses a Raspberry Pi and 
This idea of forming stronger RFID reader. There’s also a 
connections with objects through volume control for playback and 
touch and sound is the heart of lights to indicate when the unit 


The team aim to break the 
disappointing, yet often 
necessary, Do Not Touch stigma 


the Museum in a Box objective. is powered and functional. Each 
Through 3D-printed models and object, whether it be 3D or flat, 
wooden sculptures, 2D images such _ is kitted out with its own unique 
as postcards and photographs, RFID tag. When placed upon the 
and ‘do it yourself’ feedback box, the tag is read by the reader 
cards, the team aim to break the beneath the surface and informs 
disappointing, yet often necessary, the Raspberry Pi to play back the 
Do Not Touch stigma of museums, appropriate sound file via a built- 
allowing everyone the chance to in speaker system. 
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Projects 


The approachable nature of the 
Raspberry Pi brain could easily 
allow for classes to code their 


own Museum in a Box 


The sound files vary from object 
to object. Some play music, such 
as the Planets prototype box; 
home to seven identical wooden 
balls, it is set to play one of the 
seven tracks of Gustav Holst’s 
The Planets suite. While the balls 
lack any differentiation on the 
outside, their insides are unique. 
Boop a ball and the experience is 
overpowering, thanks in part to 
the beautiful effect of the USAF 


Heritage of America Band as 
the sound of their instruments 
swells into life. Now imagine 

if these balls were 3D prints of 
the instruments that played 
famous solos. Or imagine if the 
ball was the 3D-printed bust of a 
famous composer who narrates 
the inspiration behind their 
work as their music plays in the 
background, captivating young 
and old musicians alike. 


Inspired education 

It’s difficult to experience this 
project without finding yourself 
coming up with hundreds of your 
own ideas for its use. 

Given this inevitable excitement 
and enthusiasm, the second 
intention of the project comes to 
life. Imagine if a classroom had 
its own Museum in a Box, and, 
alongside their brain box, the 
students had a second box allowing 


A radio-frequency 
identification (RFID) tag is an 
inexpensive way of giving an 
item its own unique, readable 
code. Often confused with the 
NFC technology that allows 
you to touch your mobile 
phone to pay at your local 
supermarket or coffee shop, 


an RFID tag is a fairly simple 
piece of technology that can 


either be active, maintaining 
its own power source to allow 
you to use it to find lost keys, 
or passive, taking power from 
an RFID reader to let you into 
a locked building with the 
touch of a plastic card. 
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As the identical planets 
play their own themes, 
imagine the fun of 

guessing which is which 


them to record content onto their 
own RFID tags. Maybe the class 
collects objects from their local 
town and records the items’ history 
and their own thoughts directly to 
them. Once complete, they’re able 
to send the objects to a different 
class in a different part of the world 
and share their experiences with 
others. Perhaps a museum records 
narration to a postcard and sends 

it out to teachers for them to share 
with their students. The nature of 
the Raspberry Pi allows for multiple 
data files, so a first boop could 

ask a question and further boops 
could provide more information to 
continue class discussion. 

The team — whose core members 
include CEO and co-founder 
George Oates, an interactive 
designer and project manager; co- 
founder and designer Tom Flynn, 
al oer Were unre wach cel 
lead Alan McEwan, and junior 


The British Museum 
displays a mere 1% of 
its collection, leaving so 
much kept from sight 
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designer Charlie Cattel-Killick —- 
use their combined expertise to 
build constantly upon the core 
concept of the project. A great 
multi-platform use of the box is a 
recent integration with augmented 
reality. Cards depicting the fire- 
damaged ruins of pieces from South 
London’s Cuming Museum can be 
scanned with the ‘Augment’ mobile 
app and brought back to life before 
your eyes. Pair this with an RFID 
tag and these lost pieces of history 
suddenly tell their story. Download 
the app and try it for yourself with 
the image here: magpi.cc/2iLUCUA. 
At last count, the team had 
13 prototype boxes, with others 
already commissioned for use 
in programmes such as the 
Smithsonian Libraries’ ‘I See 
Wonder’ pilot; and with such 
incredible scope for use in 
education, it’s not hard to see 
Museum in a Box thriving. 


MUSEUM IN A BOX 


Projects 


afi’ 
er rv i 


magpi.cc/2iLkM4Z 
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BOOT CUFF 


When Lauren Egts spent time interning at NASA, 
she used a Raspberry Pi to put a moon camera on her foot 


Quick 
Facts 


>» The ALSCC 
was used by 


auren Egts has spent the 
A waterproof boot last three years interning 


is used to simulate for NASA, where she has 
the footwear used 


ie] sie by an astronaut worked on a range of quirky and 
Crater exciting projects. 


Whe SCSI seer Cult Sune ce 
» The BCSI A gyroscope is 
can be used cae a tothe Imager) is her latest project. 
all day ona heceiteey Pi. UH It uses a Raspberry Pi Camera 
single charge Sis pelea el Module and a gyroscope to take 
> The ASLCC every footstep close-up photographs of the floor. 


took 
stereograph 
photographs 


This project is a modern take on 
BAAN A at £ a NASA device called the ALSCC 
is attached to the (Apollo Lunar Surface Closeup 
pair ae Hide Camera). This camera went all 
surface the way to the moon and back. 
“The ALSCC was designed by 
Thomas Gold, a British scientist,” 
aad tices explains Lauren. 
was 11 inches 
(approx 28cm) ) “{He] created it to view surface 
from the floor) material from the moon. The 
images that the ALSCC brought 
back to Earth show what the 
surface of the moon looks like from 
eleven inches up. This is about the 
equivalent of an Apollo astronaut 
putting his faceplate to the lunar 
surface and looking at it.” 
NASA don’t want close-ups 
of the moon’s soil for the fun 
of it, says Lauren: “It was used 
to discover more information 
about the moon’s surface and 
structure. These are things that 
lunar soil brought back to Earth 
can’t show because it has 
been disturbed. 

“The ALSCC had a right and 
left lens that took a picture at 
the same time and from those 
2D pairs of images, scientists 


» The BCSI 
captures 
1920x1080 
digital 
photographs 


ee 
8 
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Image courtesy of NASA 


Astronauts used the ALSCC 
manually while walking around the 
lunar landscape 


back on Earth were able to create 


3D pictures of the moon’s surface.” 


The 3D effect enabled scientists 
to analyse the surface of the moon 
back on Earth. 


The BCSI 

“The concept of BCSI is very similar 
to ALSCC,” says Lauren. “They both 
take up-close pictures of soil.” 

Thanks to modern components, 
the BCSI is much smaller than the 
ALSCC. And smart components 
like the Raspberry Pi automate the 
process of taking photographs. 

“The BCSIis meant to sit on 
the ankle of an astronaut’s boot,” 
explains Lauren. It automatically 
detects deceleration witha 
eyroscope each time an astronaut 
takes a step. “Once deceleration 
is detected, the program that 
runs on the Raspberry Pi triggers 
the Camera Module. 

“Of course, on the moon or Mars, 
there wouldn’t be as much gravity, 
so the trigger value to take a picture 
would be much different,” she 
reveals. “But through testing I’ve 
determined a consistent value that 
returns clear pictures.” 


Working for NASA 


Lauren worked hard to get her 
NASA internship. “I met my 
mentor, Herb Schilling, at a Mini 
Maker Faire where | was presenting 
on Scratch,” says Lauren. “He 
invited me to come shadow him at 
his lab at NASA for a day.” 
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Image courtesy of NASA 


After the shadow, he invited her 
to intern at the lab for a few weeks 
that summer; she came back the 
next summer and the next. 

“A friend of my mentor 
had heard about the ALSCC 
and thought that it would be 
interesting to create a modern 
version of it,” recalls Lauren. 

“T had a good idea of what | 
wanted the design to look like. I 
decided to sacrifice a pair of socks 
to science and use them to create 


Projects 


the next version of BCSI. The sock 
prototype was much more robust 
but couldn’t be used in the field, so 
I ended up getting an off-the-shelf 
pair of rainboots and attaching the 
BCSI to one of them.” 

Lauren tells us that working at 
NASA is a lot of fun. “I think my 
favourite part of the lab is the 
people. We range in age from high 
schoolers to graduate students, but 
we all have one thing in common: 
we love technology.” 
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JOHANNES JAEGERS 


A robot maker with many years 
of electronics and tech project 
management under his belt. 


german-robot.com 


A real humanoid robot powered 


by a Raspberry Pi, the German 
Robot (GeRo) is like a more 
advanced Rapiro 


34 


There are 
plans fora 
bigger, more 
manoeuvrable 
robot 


This is the first 
Raspberry 

Pi project 
Johannes 


has made 


Full build 
instructions, 
including an 

SD image, are 
available online 


With 3D printed 
parts, you can 
easily modify 
how GeRo 
looks 


GeRo has five 
more servos 
than Rapiro 


ve been fascinated by 
humanoid robots for a long 
time,” Johannes Jaegers, 
the creator of GeRo, tells us. “I 
finally decided to make one myself 
when I saw the Rapiro project 

on Kickstarter.” 

From this fascination comes 
GeRo, the German Robot. It’s a 
walking, talking robo- project 
running on a Raspberry Pi. GeRo 
is fully programmable by the 
user and can even be controlled 
remotely over the network from 
any web browser. The camera and 
microphone also stream to the 
webpage connected to it. 

For this type of complex robot, 
a Raspberry Pi is not always 
used, with some makers using 
Arduino controllers to do the job. 
“| preterred a computer over an 
Arduino,” Johannes explains. 
“Using a computer like the Pi 
allows for many more features 
like the camera and microphone 


With stickers and 


higher-quality 3D 
printing, GeRo can 
look great 


connection, ROS integration, 
sensor data evaluation, reactions, 
and so on. I chose the Raspberry 
Pi because it was cheap and it had 


3D-printing heads allows for customisation of the robot 
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The camera peeks 
out of the nose to 
stream video 


Dress the robot 
up and make 
him part of 
your family 


a great online community which 
supports a lot of functions like 
software PWM which is needed to 
connect the 17 servos.” 

ROS is the Robot Operating 
system, an open-source OS 
specifically for creating and 
programming robots. It’s used in 
the GeRo, making it fairly unusual 
among Raspberry Pi robots, which 
usually just work with Raspbian. 

It took Johannes about two years 
on and off to build the robot. It 
consists of a metal skeleton and 
3D-printed parts, along witha 
custom PCB to power the Raspberry 
Piandteconnech te tien 7 indniduiall 
servos and the battery. There is 
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PROGRAM YOUR ROBOT 


a full list of parts online you can 
read, which gets a little extensive 
when you get down to the nitty- 
eritty: magpi.cc/2fQ7kor. 

“In general it works quite well,” 
States Johannes. “However to 
do anything with the robot, the 
movements and the text for speech 
have to be defined. I wrote software 
to make the positioning of each 
Servo as easy aS moving a Slider; 
however, it still takes some work 
and time to perform, especially for 
the walking sequence. The robot 
has no servos to turn the legs 
around, so it’s limited to walking in 


en anner (1) * 


>STEP-02 


a Straight line for now, and cannot 

easily turn. However, it can stand 

up from any position and speak any 

sentence in different languages.” 
Johannes has recently made 

the process of building the 

robot, along with some of the 

materials, accessible online 

from german-robot.com, and 

he reckons you can build the 

robot for less than 500 euros 

(about 6430/8530). It’s not 

overly complex, but Johannes 

reckons it’s best to have some 

level of understanding of robot 

hardware and software and how 


Prototypes and alternative ways of building up your GeRo 
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GERO 


Projects 


>STEP-03 


they can interact, along with 

some soldering experience to boot. 
“T really enjoyed working with the 
Raspberry Pi, especially because it 


It took Johannes about 
two years on and off 
to build the robot 


supports ROS and made it so cheap 
and easy to get direct hardware 
access from Python and C and thus 
build complex systems.” 


Below You'll need 
quite a lot of parts 
to build this robot 
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pi-top 


10 Hour 
Battery Life 


| FO a 
HD Screen 


Modular 
Components 


$264° 


without Raspberry Pi 
ex VAT 


& 
|= to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our Latest news by following our social media 


pi-topCEED 


Adjustable 
Viewing Angles 


14” 
HD Screen 


Modular 
Components 


$4 149° 


without Raspberry Pi 
ex VAT 


Available in green or grey colours 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop’ 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long you'll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 


‘q “ 
pi-topPROTO pi-topsPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a e Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any e 2W per module 
Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible e High quality SPDIF digital audio 
prototyping board! from HDMI 


e I12C controlled 


Our Official @\l/ - & 
Distributors adarruit HH LENce — KIwI@electronics =~ SKUBIi| ©MODMYPI MICO CNET & PrSnor.cu RS Sparkfun. . 


By using the command line, you are able to work faster and smarter. 
Discover how to get started today... 


® OCB ® CB BBeresprenp: - 


a — 


® Gy ls) > 8 ES ci@raspbenyp ~/D Vax ea | 58/1410 pi@ 


pi@tespberryoi_~/Documents 


raspberryp1 


~/Documents 


6 @ = 9 EBB icraspberypi ~ - Vek a | 13%) 1437 
ae See ere 
pl@raspberrypil: ls -lah /home/pi/Documents/ 

total 20K 


drwxr-xr-x 5 pl pi 4.0K Dec 15 14:37 

drwxr-xr-xX 31 pl pi 4.0K Dec 15 12:52 

-rw-r--r-- 1 pl pl O Dec 15 14:37 a_file.txt 
drwxr-xr-x 11 pi 4.0K Nov 25 17:49 

drwxr-xr-x 5 pi 4.0K Nov 25 17:49 

drwxr-xr-x 2 pi pl 4.0K Nov 25 17:46 
pi@raspberrypi: if 


pi@raspberrypi: ~ 


xdg-open Tree 


e Ugly.png 


Tree 


The permission structure 


of a Unix file or directory x& Rg 


\ 
file x& x ae 


directory owner group other 


system 
Filesystem: 
Password: 


Hostname: raspberrypi 


Boot: © To Desktop © |To CLI 


Auto Login: # Login as user ‘pi’ 
Network at Boot: \) Wait for network 


Splash Screen: © Enabled 2) Disabled 
Underscan: © Enabled © Disabled 
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Options 

Most commands have options that affect how they 
work. It’s common to use these three options with 
the 1s command: 


ls -lah 


Options start with a single hyphen ‘-’ followed the 


letter for each option. The three options used here are: 


-1 = long listing format 

-a = all including hidden files 

-h = human-readable (makes large file sizes 
more readable) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small ‘I’ is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
sameasls -lah: 


ls -1 --all --human-readable 


But it’s more common to see (and use) the single 
letter approach. 


Sudo 
Sudo stands for ‘substitute user do’, although it’s 
often also called ‘superuser do’. If you have multiple 
users On your system, it can be used to perform 
commands as another user. 

It’s mostly used to get root access to your Linux 
installation. There is an account that controls your 
Pi user, called ‘root’. This is an all-powerful account, 


which can change just about anything on your system. 


Your default account can view files in the root of 
the hard drive, but it can’t create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You’ll see touch: cannot touch ‘test.txt’: 
Permission denied. However, enter: 


sudo touch test.txt 


..and the test.txt file will be created on the root of 
your hard drive. You can see it using1s -1. 
Now try to delete it: 


rm test.txt 
It will say rm: remove write-protected regular 
empty file ‘test.txt’?” Enter Y and it’ll say rm: 


cannot remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 
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COMMAND L 


sudo rm test.txt 


You can see why sudo is such a powerful tool. 
Without it, you couldn’t install software using apt 
or apt-get. But with it, you can remove or delete vital 
system files. Enter 1s /bin and you’ll see many 
programs (known as ‘binaries’) used by Linux. These 
include the 1s command you just used. Accidentally 
deleting these files could make your system unstable. 

So use sudo with care. In Raspbian you don’t need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to is man. This stands for ‘manual’ and gives you 
instructions on Linux commands and tools. Enter: 


man ls 


...and you’ll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 
Almost all commands are in the ‘command, option, 
argument’ structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or --help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to acomman4d line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don’t head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it’ll be second nature. 


> GoPiGo kit 


magpi.cc/ 
2hA8f6i 


> WiFi dongle 
magpi.cc/ 
2hAgOOC 


> Speaker 
magpi.cc/ 
2hAgCi7 


> Ultrasonic sensor 
magpi.cc/ 
2hAazds 


> Button sensor 
magpi.cc/ 
2hAhqE1 


> Raspberry Pi 
Camera Module 
magpi.cc/ 
28ljlsz 


JOHN COLE 


Travelling bearded nerd with a heart 
powered by coffee and an unfocused 
mind. 2016 Presidential candidate. 
Engineer at Dexter Industries. 
dexterindustries.com 


The Raspberry Pi Camera 
Module takes a picture 
of the human subject 


The speaker is used to say 
some words back from the 
robot to the human subject, 
depending on their mood 


THE RASPBERRY PI ROBOT 
THAT READS EMOTIONS 


In this project we’ll build a Raspberry Pi robot with emotional 
intelligence using the Raspberry Pi Camera Module to tell if a person is 


happy, sad, angry, or surprised 


hat if you could build a robot with some 

empathy? This tutorial will show you how to 

build a robot that can read a person’s face 
for emotions. In this tutorial we’ll use the Raspberry 
Pi, the Raspberry Pi Camera Module, aGoPiGo, anda 
speaker to read some human faces and say something 
appropriate back. Our robot will roll up to its human 
master, take a picture, analyse the face with a free 
Google Cloud Vision account, and then say something 
appropriate to the human’s current mood. 


Build the GoPiGo 

You will need a small Phillips head screwdriver; the 
rest of the parts are included with the GoPiGo. There 
are written directions and video instructions on the 
Dexter Industries site showing how to assemble 

the GoPiGo robot kit. Attach the Raspberry Pi, and 
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add eight AA batteries to power the GoPiGo. While 
programming the stationary GoPiGo, you may want 
to use a USB power supply to power the Pi. 


Add the camera 

Add the Raspberry Pi Camera Module to the GoPiGo. 

In this tutorial, we’ll use one of the slots on the top of 
the GoPiGo canopy to support the camera. You can also 
use the servo accessory to move the camera side to side. 


Add the speaker 

The speaker can be mounted to the top of the GoPiGo 
using a few zip ties. Place the speaker on top of the 
GoPiGo, and connect the speaker aux cable to the 
Raspberry Pi headphone port. You can charge the 
speaker using the Raspberry Pi USB cable. 
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>STEP-04 

Attach the sensors 

We use the button sensor to give us an easy way to start 
the robot up once the code is running, and the distance 
sensor to judge how far we are from the human. Hang 
the ultrasonic distance sensor from the front of the 
GoPiGo, using small zip ties, and attach the button 

to the top of the GoPiGo, also using zip ties. 


>STEP-05 

Setup a free Google Cloud Vision account 

You can use your Gmail or Google account to set this up. 
At the time of publication, Google offers a 60-day free 
account — magpi.cc/2hAkotl. 


>STEP-06 
Create a new project 
This is an abbreviated version of the setup process. 
You can see a pictorial walk-through of how to 
set up a new project in Google Cloud Vision online 
here: magpi.cc/2hAhHqc. 
Create a new project called ‘vision1’. Enable the Cloud 
Vision API for vision1. 


>STEP-07 


Download and install your JSON credentials 
Head back to the Console in Google Cloud. Find 
the box titled ‘Use Google APIs’ and click ‘Enable 
and manage APIs’. Click on Credentials and Create 
Credentials. Credentials is on the left-hand side, 
with a picture of a key next to it. Select ‘Create 

a Service Account Key’. Under Service Account, 
select New Service Account. We’1l call this ‘vision’. 
Finally, create a role. We’ll give the new role full 
access, so select Project and Owner to give the Pi 
full access to all resources. A pop-up window should 
appear telling you that you have created a new key, 


Above This project was tested on babies 
and it works just fine on them too 
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Tutorial 


EMPATHYBOT 


Above This project really only works well on non-bearded 
humans. Beards interfere with the software. 


qanquage’ 
and an automatic download of the JSON key should att 
begin. Keep track of this file! You should now use 
an FTP program (such as FileZilla) or Samba (see 
our tutorial at youtu.be/CEYwYqkAPfA) to move 
the JSON file over to your Raspberry Pi. Place the 
JSON file in the home directory /home/p1. 


>STEP-08 

Prepare the Raspberry Pi 

We need to run a few commands to prepare the 
Raspberry Pi. We only need to do this one time. 

In the command line, run the following commands: 


DOWNLOAD: 
magpi.cc/2hAgqiT 


sudo pip install --upgrade pip 

sudo apt-get install libjpeg8-dev 

sudo pip install --upgrade google-api-python-client 
sudo pip install --upgrade Pillow 

sudo apt-get install python-picamera 


Finally, make the credentials we downloaded in the 
previous step available to Python: 


export GOOGLE _APPLICATION_ 
CREDENTIALS=filename. json 


Here, replace ‘filename’ with the name of your JSON file. 


>STEP-09 
Run the code 


If you’ve taken the code from our GitHub repo, or typed 
it out yourself, you can now run the code: 


sudo python empathybot. py 
Point the robot towards your human subject, press the 


Grove button on the GoPiGo, and let your robot start 
interacting with some humans! 
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Tutorial 


> Raspberry Pi 
Zero V1.3 and 
Raspberry Pi1B 
or B+ 


> Pi NoIR 
Camera Module 
magpi.cc/ 
2hND1itw 


> Pi Zero 
camera cable 
magpli.cc/ 
1V5Nodh 


> USB to micro- 
USB adapter 


> Infrared 
illuminator 
magpi.cc/ 
2jxw3sT 


> 12V power supply 


> Power supply 
adapters 
magpi.cc/ 
2hNFuEy 


> 5V UBEC 
magpli.cc/ 
2hNMv8z 


> WiFi dongle with 
antenna 


> Waterproof case 


> Two short 
lengths of 
jumper wire 


Long-range 
antennae for 
WiFi connectivity 
anywhere in 

the garden 


See in the dark with 
infrared light only 
visible to the Pi NoIR 
Camera Module 


Full HD night-vision 
camera to record 
any secret antics! 


MAKE A 


HENRY BUDDEN 


Following the release of the Raspberry 
Pi when he was 12, Henry taught 
himself to code and to use/break 
electronics, and has shared this 
process with the world on his website. 
magpi.cc /2eCbaMf 


Build a motion-detecting camera that streams to the internet 


and can see in the dark! 
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ith night-vision and the MotionEyeOS 

installed, the camera trap can be installed 

outside as a home security camera, a nature- 
trap, or a neighbour-watcher (careful!). The operating 
system MotionEyeOS allows the camera to be viewed 
online as well as alerting you when motion is detected. 
Built inside a waterproof case, and powered by mains 
electricity, the setup is also equipped with a high- 
power infrared illuminator to light up the darkness. 


Prepare case 

The first step is to drill all of the holes in the 
waterproof container of your choice (it must be 
transparent) in order to mount all of the necessary 
components. For our choice of case, we needed to drill 
two holes: one for the power socket and two for the 
WiFi antennae. Whilst the diameter and the distance 
needed between the holes for different WiFi antennae 
and power sockets may differ, we used a 7mm bit for 
the power socket and drilled two 10mm holes for the 
WiFi antennae. If the holes appear slightly too large 
once drilled, don’t worry: the gaps will be filled with 
hot glue when mounting the components. 


Wire the power circuit 

After preparing the case for the mounting of the 
components, the next step is to wire up the power 
circuit. The female barrel jack socket will be mounted 
inside the hole drilled earlier, with two connections 
from each screw terminal. One pair of wires connected 
to the negative and positive terminals will be 
connected to the male barrel jack connector screw 
terminals, with the other pair of wires connecting 

to the corresponding negative and positive inputs 
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MOTION IN 
BACKGROUND 


Image courtesy of ModMyPi 


Connecting 
the UBEC to the Pi 
via a pre-soldered 
header 


on the UBEC, where the wires are already attached. 
Connecting the UBEC to the Raspberry Pi in order to 
supply power will be covered in the next step. 


Powering the Raspberry Pi 

In order to supply power to the Raspberry Pi Zero, 
the UBEC can be connected to your Pi in two different 
ways: either by soldering the connections directly 

to the GPIO, or by attaching the three-pin socket on ; AS 
the UBEC to the Pi via a pre-soldered header. The co eo egee es 43 
photos show the output wires from the UBEC soldered J 
directly onto the Pi’s 5V and GND pins (pins number 2 
and 6). Alternatively, you could solder a GPIO header 
onto the Pi and simply plug the UBEC’s three-pin 
socket into the GPIO header — pins 2, 4, and 6 - 
making sure the black wire is connected to pin 6. 


ITfeerrenin 


Bi | 
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Connect the power circuit 

The two input leads of the UBEC should be screwed 
into the corresponding terminals on the female barrel 
jack adapter, as well as two jumper wires connected to 
the correct terminals on the male barrel jack adapter. 
Using a hot glue gun, the female barrel jack socket can 
be attached to the hole that was drilled in the rear of 
the casing. Secondly, the UBEC can be attached to the 
inside of the casing in the same way. Finally, the male 
barrel jack adapter can be attached to the opposite 
side of the casing as the UBEC (see photos) to later be 
attached to the infrared illuminator. 


Connection 
from the output 
of the UBEC to the 
Pi's 5V and GND 
GPIO pins 
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MOTION 
ALERTS 


Mount the IR illuminator «= 
; , ° 
Using a few small dots of hot glue, the infrared dil 
illuminator can be fixed to top of the case’s lid, as P I AMM 
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i 


SE Py 


Above The shown in the photographs. The power lead from this ’ y | , 
inner layoutand + odule can then be connected to the male barrel jack uy , 
connections of the J mm 
camerasetup adapter now fixed to the side of the case. More hot ‘ 


CLOUD 
BACKUP 


In order for 
the recorded 
files to be 
backed up, 
you can select 
Google Drive 
or Dropbox 
from the 

File Storage 
menu, clicking 
Obtain Key 

to gain 
permissions. 


elue may be needed to ensure a good fix, especially 
accounting for the stress applied to the cable when 
the box is opened or closed. 


>STEP-06 

Mount the WiFi and antennae 

With the two holes for the antennae already drilled 
the correct distance from each other, the WiFi module 
can easily be attached to the casing by pushing the 
antennae through the holes from the inside of the 
case. Once the WiFi antennae are in position, they 
can be fixed (and waterproofed) by using the hot 
elue gun to create a circular seal around the outside 
of the holes. The WiFi module is connected to the Pi 
by connecting the USB to micro USB adapter to the 
socket marked ‘USB’ on the Pi, and the USB plug on 
the WiFi module. 


>STEP-07 

Mount the Raspberry Pi and Camera Module 

In this tutorial, we mounted both the Raspberry Pi Zero 
and Pi NoIR Camera module to the casing using eight 
hexagonal stand-offs; however, this is not necessary. 
With some improvisation, makeshift stand-offs can 
be created from common materials like wooden dowel. 
Both the Raspberry Pi and Camera Module are attached 
to the casing using hot glue. As the pictures show, we 
mounted the Camera Module upside-down in order to 
remove any kinks in the camera cable. The software 
can correct this inversion at a later time. 
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Above The camera works well when positioned in a spot where 
interesting activity is to be expected, like a hole in a fence 


>STEP-08 

Install MotionEyeOS 

On a computer, visit magpi.cc/1UCw1Jk and download 
the image shown as compatible with the Raspberry Pi 
Zero. Once downloaded, extract the IMG file from the 
. tar.gz archive. We did this using a program called 
7zip. Finally, using a disk imaging tool like Win32 Disk 
Imager, write the IMG file to a micro SD card. As the 
OS does not create an interface on the Pi, initial setup 
will need to be performed on a Raspberry Pi 1 Model 

B or B+, as it works with the same version of the OS 

as the Zero and has Ethernet connectivity. This is 
because WiFi cannot be configured yet, unless you use 
one of the two methods for preconfiguring it before 
first boot (magpi.cc/2iuKzhx), in which case the older 
model Pi isn’t needed and you can insert the card 
Straight into the Pi Zero. 


>STEP-09 

Connect to MotionEyeO0S 

Insert the micro SD card into the older Raspberry Pi 
model and connect the Camera Module. Power on, 
ensuring it is connected to your home network via 
Ethernet. After approximately two minutes, use an 
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12V Input 


Above Asimple diagram illustrating the power distribution circuit 


IP address scanner like the mobile app Fing and look 
for the IP address of a device name beginning with 
‘meye-’. Enter this IP address into your browser’s URL 
bar, which will direct you to the page generated by the 
Raspberry Pi, showing the live feed from the camera, 
if connected to the older model Pi. The next step will 
show you how to set up a WiFi connection so that the 
Raspberry Pi Zero (and WiFi dongle) can be used. 


>STEP-10 

Set up WiFi connection 

When your browser is presented with the 
MotionEyeOS interface provided by the older 
Raspberry Pi model, navigate to the settings menu in 
the top-left corner of the screen. You may need to set 
up an admin user name and password beforehand. 
Under the Networks tab, switch Wireless Connection 
on, and fill in the Wireless Network Name and 
Wireless Network Key fields with the name and 
password for your wireless network, ensuring that the 
details are added with 100% accuracy. Once completed, 
click Apply and allow the system to reboot. Once 
rebooted, power off and insert the micro SD card into 
the Pi Zero in the casing, then boot it by connecting 
the 12V supply to the socket in the rear of the case. 


>STEP-11 

Configure MotionEyeOS 

Connect to the Pi Zero in the same way as before, 
although you may need to rescan to find the IP address 
if it’s changed. Once connected, there are a couple of 
settings that need tweaking before the camera can 

be let loose! Firstly, as the camera is mounted witha 
180° flip, the Video Rotation setting under the Video 
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NIGHT-VISION CAMERA TRAP 


Tutorial 


Raspberry Pi 


oV UBEC 


IR LED Array 


Device menu should be updated to 180. Finally, if you 
want the camera to record video whenever it detects 
motion, make sure that the Motion Detection and 
Movies settings are switched on. 


>STEP-12 

Using the camera 

Now that everything is ready, the camera is free to be 
placed in the wild! When choosing a location for the 
camera, make sure that an extension power cable is 
able to reach it, and that the camera is pointing ina 
direction where you would expect some interesting 
animal activity, such as a gap ina fence. Finally, 
check that where you are placing the camera has 

a decent WiFi signal, otherwise the camera will 
continuously reboot until it finds a connection, 

and no footage will be collected. Good luck! 


> 


Above Putting 
the camera next 
to the front door 
allows you to see 
who's been visiting 
during the day! 


SET UP 
WITHOUT 
EXTRA Pl 


In order 

to set up 
MotionEyeOS 
without the 
need for an 
additional 
earlier model 
Pi, follow the 
instructions 
found here: 
magpi.cc/ 
tUCVYwV 
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Tutorial 


AN INTRODUCTION TO C 
THE STRING LIBRARY 


Using the C string library to simplify common operations on strings 


KEEP INSIDE 
YOUR STRING _ 
n the last instalment, we saw how to join two 

The string strings together using pointers. We’re now 
library 
functions will | going to do the same thing using the string 
not generally handling library, which saves a lot of space: 
prevent you 
from writing ‘ ‘ 
Be ee seat puncrude SLE Sal te 
as when using void main (void) 
pointers, when { 
using library 53 z 
functions you char stri[10] = "first"; 
still need to char str2[10] = "second"; 
ieee char str3[20]; 
your string 
variables are strcpy (str3, str1); 
large enough strcat (str3, str2); 
Bed P adie Gio printf ("%s + %s = %s\n", str1, str2, 
you are writing 
into them. str3); 

} 


Note the #include <string.h> at the start, which 
tells the compiler that we want to use functions from 
the string library. 

This shows two string functions. strcpy (‘string 
copy’) copies the string at the second argument to 
the start of string at the first argument. strcat 
(‘string concatenate’) does the same thing, but 
instead it finds the terminating zero of the first 
argument and Starts copying to its location, thereby 
joining the two strings together. 


Below The sscanf 
function reads 
numeric values 
and words out 

of a formatted 
string, allowing 
you to parse text 
from elsewhere. 
All the arguments 
to sscanf must 
be pointers 


Nee “sth ng.c-/home/pi-Geany 
File Edit Search View Document Project Build Tools Help 


Vy ay lp x Se-~ g @\aQ@ 4\> |B 
S|; Symbols > array.c * | String.c * | 
104 
a ag et 105 #include <stdio.h> 

& main [4] 106 
107 void main (void) 
108 { 
109 int val; 
110 char result[10]; 
111 char string{[2S] = "The first number is 1’; 
112 
113 if (sscanf (string, “The “s number is Se", result, S&val) == 2) 
114 
115 printf (*String : %s Value : %d\n*, result, val); 
116 } 
117 else 
118 
119 printf (*I couldn’t find two values in that string.\n*); 
120 
121 } | 
122 
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Comparing strings 
We use the == operator to compare numeric values, 
but this doesn’t work with strings. The name of a 
String is actually a pointer to a location in memory 
containing the string, so using == to compare two 
strings will only tell you if they are at the same 
place in memory. 

You can use == to compare two char variables, and 
a string is an array of chars, so it is possible to write 
a Simple piece of code that compares each character 
in a String in turn: 


#include <stdio.h> 
void main (void) 
{ 
char stri[10] = "first"; 
char str2[10] = "fire"; 
char *ptri = stri, *ptr2 = str2; 
while (*ptr1 != @ && *ptr2 != Q) 
{ 
if (*ptri1 != *ptr2) 
{ 
break; 
} 
ptri++; 
ptr2++; 
} 
if (*ptri1 == 6 && *ptr2 == 0) 
{ 
printf ("The two strings are 
identical.\n"); 
} 
else 
{ 
printf ("The two strings are 
different.\n"); 


The string library makes this much easier with 
strcmp (for ‘string compare’): 
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Mome/pi - Geany 


6@ stning.c - 


Wastebas 
Sv @v lp x 3S Oer & 
<|_ Symbols [> | armay.c 3% | string.c * 
| 1 #include <stdio.h> 
F 
Praons #include <string.h> 
& main (4) 3 
4 void main (void) 
5 { 
6 char stri[{10) = "first 
7 char str2(10] = *second 
8 char str3[20); 
9 
10 strepy (str3, strl); 
11 strceat (str3, str2); 
12 . 
13 printf ("ss + %s = %s\n", 
14 } 


#include <stdio.h> 
#include <string.h> 
void main (void) 
{ 
char stri[10] = "first"; 
char str2[10] = "fire"; 
if (strcmp (str1, str2) == 0) 
{ 


printf ("The two strings are identical.\n"); 


} 


else 


{ 


printf ("The two strings are different.\n"); 


} 
} 


strcmp takes two strings as arguments, and returns a 
oO if they are the same; it returns a non-zero value if not. 

To compare the first few characters of a string, use 
the function strnemp (for ‘string numbered compare’). 
This works in the same way as strcmp, but it takes 
a third argument, an integer giving the number of 
characters to compare. So strncmp ("first", "fire", 
4) would return a non-zero value, while strncmp 
("first", "fire", 3) would returnao. 


Reading values from a string 
The function sscanf (‘string scan formatted’) can be 
used to read variables from a string: 


#include <stdio.h> 
void main (void) 
{ 
int val; 
char string[10] = "250"; 
sscanf (string, "%d", &val); 
printf ("The value in the string is %d\n", val); 


sscanf uses the same format specifiers as printf, 
but all its arguments must be pointers to variables rather 
than variables themselves: as always, a function can never 
change the values of variables provided as arguments, but 
it can write to their destinations if they are pointers. 
sscanf returns the number of values successfully 
read. So if a format specifier of %d is provided but the 
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strl, str2, str3); 
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strcpy is the library function 
to copy a string from one 
pointer to another 


DON'T 
OVERWRITE 


It looks like 

it ought to 

be possible 
using strcpy 
and strcat to 
copy part of 

a string over 
itself - strcpy 
(a + 1, a), 
for example. 
Don't try it! The 
source and 
destination 
buffers for 
strcpy and 
strcat must be 
completely 
separate areas 
of memory; 

if not, their 
behaviour is 
unpredictable. 


g\Q 


f 


strcat is the library function 
to concatenate two strings 


File Edit Tabs Help 


string supplied doesn’t start with a decimal number, 
sscanf will write nothing to the supplied pointer and 
will return 0; if the string supplied does start with a 
decimal number, sscanf will return 1. 

The format string supplied to sscanf can have 
multiple format specifiers and even other text: 


#include <stdio.h> 
void main (void) 
{ 
int val; 
char result[10]; 
char string[25] = "The first number is 1"; 
if (sscanf (string, "The %s number is %d", result, &val) == 2) 


{ 


printf ("String : %s Value : %d\n", result, val); 


} 


else 


{ 
printf ("I couldn't find two values in that string.\n"); 
} 
} 


Note that, slightly inconsistently, the %s format 
specifier denotes a pointer to a string in both printf 
and sscanf, while the %d specifier denotes a variable 
in printf but a pointer in sscanf. 


How long is a (piece of) string? 

One other string handling function is strlen 

(for ‘string length’) - this tells you how many 
characters are in a String, including the terminating 
zero character. 


IGNORING 
CASE 


There are 
versions of 
strcmp and 
strncmp which 
ignore the 
case of the 
letters in the 
strings being 
compared - 
they are called 
strcasecmp 
ale! 
strncasemp, 
respectively; 
they take 

the same 
arguments 
and return the 
same values. 


#include <stdio.h> 
#include <string.h> 
void main (void) 
{ 
char stri[10] = "first"; 
printf ("The length of the string '%s' 
is %“%d\n", stri1, strlen (str1)); 


All the string operations above are possible by 
manipulating pointers, but the string library makes 
life much easier! 
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You ll 


Need 


> Empty Pringles 
cans 


bapyerole Make your own auto repeating pattern drum kit 


stripboard 


. 2N7000 FETs his is a fun project where you have a set of is flashed in the appropriate drum. One of the easiest 

eee drums to play, but the twist is that what parts of making this was the eating of the Pringles 

2 : 
geting sp orciors every sequence you play, it gets repeated, before we could start. 
until you play something else. The idea is to have five 

> OVL-5521 white , Th H it 

LEDs finger drums, each one playing its own sample and e CIFcul 

. when you stop playing, the sequence is automatically Each drum has its own circuit built into it, the 
> 3V3 Zener diodes : 2 : 3 
replayed. The drums are made from small empty schematic for this is shown in Fig 1. Note that there 

‘ alent rua Pringles tubes with piezo sensors on the plastic lids. needs to be five of these circuits, one for each drum, 

diades : When the sequence is playing back, a powerful LED and while the circuit is the same in each drum, the 


> Piezo sensors _ = 


> Assorted resistors |i Finger-tapped drum The piezo sensors The drum lights 
and wires | made from the finest detect a tap on the drum up when playing 


stackable-snack tube 
> Hot-melt glue 


4 [ dj f es 


oV 


Drum12345 
GPIOSs 16,14,21,8,23 


GPIOs 20,15,12,7,24 


2N7000 


+ 


Sensor 


~\. “LN 


Ground 
D2 D1 
1N4868 3V3 


two GPIO pins the Pi uses is different for each one. 
We used an OVL-5521 white LED as this was the most 
powerful LED we had; it has a maximum output of 

18 candela, whereas most LEDs produce light in the 
millicandela range. In part this is due to the narrow 
angle, but it reflects off the foil interior of the tube 
very well, and lights up the drum. The forward voltage 
for this LED is 4V when passing 20mA through it, 
which is why we need to use a transistor to 
switch it, and not connect it directly to the 

Pi’s GPIO pins. You will also notice a 3V3 

Zener diode protecting the gate of the FET 

from excessive voltages and a small signal 

diode protecting against negative voltage 
excursions. In theory, the Zener should have 
protected against this by itself, but in practice 

it was not good enough. Full construction 

details are shown in the step-by-step guide. 


The Interface 

Each drum has two GPIO pins: one to control 
the LED and the other to report back the 
sensor’s response. When the sensor is hit, 

the FET conducts and puts a logic zero on 

the GPIO pin, which has been set as an input 
with the internal pull-up resistors enabled. 
The software has two modes, playing and 
listening, and will switch back automatically 
into the listening mode when a drum is played 
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ANG 


DRUMLIKEME  Wutorial 


_ 
IR 


iL 
OVL-5521 


White LED 
1K8 


BC237BG 


Fig 1 The drum 
schematic - five 
circuits are needed 


or when the space bar is pressed. When in the listening 
mode, it will switch into the playing mode when there 
has been a pause of 1.5 seconds without a drum being 
played; this delay is adjustable. 

The sensor suffers from bounce, like virtually all 
mechanical switches; in this case it is from continued 
vibrations after the initial strike. The code has 
a debounce timer where once a sensor is triggered, 


i 
Bia 
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Flat face against the board 
2N7000 


Raspberry Pi GPIO 


Ground 


Drum12345 
GPIOs 20,15,12,7,24 


GPIOs 16,14,21,8,23 
oV 


Ribbon Cable 


>STEP-01 


Build the circuit boards 
Build five circuit boards for the drum electronics; do not attach the 
ribbon cable at this stage. Make sure there is a track break underneath 


the 1k8 base resistor and the 51R LED current-limiting resistor. Attach 
6cm extension wires to the piezo sensors, and cover the joint with shrink 
sleeving, insulation tape or, as we used, self-amalgamating tape. Leave 
about icm of lead on the LED above the stripboard and push it to one 
side so that it shines directly on the tube's wall. 


all further input from it is ignored until the end of 
this time. Any debounce time is always a compromise 
between blanking out any unwanted repeated 
triggering and allowing intentional rapid retriggering 
of the drum. Again, like the start delay, this debounce 
time is configurable. 

The only things you’ ll need are the five sound 
samples for each drum. We used very short WAV files 
of drums and cymbals — you can find them on our 
GitHub page (magpi.cc/1NqJjmV) or download 
your own samples. 


Sensor 


Flat 


= OVL-5521 
«ye White LED 
Break track BC237BG 
under each 
resistor 


The software 

The full code is shown in drum.py overleaf; this is 
also available on our GitHub page. At the heart of the 
program is a couple of buffers where the time a drum 
is struck is recorded along with which drum was 
struck. At first, in the listening mode, the buffer is 
filled with the drum strike time, then, once the play 
mode is entered, the buffer times are altered to the 
time the note will be played back. In the playback 
mode, the buffer is constantly being searched to find 
if a sound is due to be played; when one is found, it 

is removed from the buffer and played and then that 
note is reinserted into the buffer but with a time that 
represents the next repeat of the sequence. 

There are a number of variables that are important 
in the fine-tuning of the code. The startDelay 
variable determines how many seconds of no drum 
input triggers the transition into play mode. The 
debounceTime variable guards against the sensor 
signal’s bouncing, but also determines the rate you 
can enter valid drum hits. This variable also controls 


>STEP-03 

Fit the circuit board 

Strip and solder the four wires of the ribbon cable 
to the board. Then cover the track side of the board 
with dual-sided sticky foam, pull the ribbon cable 
out, and manoeuvre the circuit board to the centre 
of the drum and press down. Then place some hot- 
melt glue over where the ribbon cable exits the 
drum. We could not get the glue gun into the tube, 
so we resorted to putting the glue on a wooden 
stick and transferring it to the ribbon cable - we 
used the wrong end of a small paintbrush for this. 


how long the drum’s LED is on during playback. 
The buf ferLength variable controls the number 
of hit events you can record. While it might seem 
like a good idea to make this big, too big and you 
will waste time searching the buffer and that will 
affect the playback timing. 


Taking it further 

When using this program, we have found that 
sometimes the non-real-time nature of the Linux 
operating system causes the occasional drum hit 
not to be recorded. This might be improved by 
increasing the value of the 560k resistor across the 


FET gate to 1M, although this might mean you have to 
increase the debounce time. 

You can change the number of drums quite easily: 
just have a longer list of LED and sensor pins. You 
might want to change the colour of the LEDs and have 
a different colour for each drum. Remember, you will 
also need to change the value of the LED’s current- 
limiting resistor when you do this 
because the replacement LED will 
have a different forward voltage. 

You might want to print out 
a drum graphic to wrap around 
your Pringles tube, or even use 
different flavours of Pringles for 
each drum. The drum’s LEDs do not 
light up in play mode; you might 
want to see how you can change 
the code to make that happen. 
Also, you might want to limit the 
number of drum pattern repeats 
or gradually change the tempo as 
you have more repeats. Finally, 
you might want to fix the drums 
to a base board to stop them sliding 
when you hit them. 


4) 
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#! /usr/bin/python 

# Drum Like Me Pygame framework 
import pygame, time, os 

import wiringpi as io 


pygame. init() 

os.environ[ 'SDL_VIDEO WINDOW POS'] = '‘center' 
pygame.display.set_caption("Drum like me") 

screen = pygame.display.set_mode( [300,40] ,0, 32) 
pygame.mixer.quit() 

pygame.mixer. init(frequency=22050, size=-16, channels=2, 
buffer=512) 

pygame.event.set allowed(None) 

pygame.event.set allowed([pygame.KEYDOWN, pygame.QUIT ] ) 
bufferLength = 40 # number of hits to store 

delay = @ ; startDelay = 1.6 # quiet time before playback 
# minimum time between entry 

lastEntry = @.0 ; debounceTime = @.05 

lastInstrument = -1 ; ledOn = [0.0,0.0,0.0,0.0,0.0] 
playing = False 


def main(): 
global lastPin, delay, playing, event, lastEntry, 
lastInstrument 
initResource() 
print"Drum like Me - By Mike Cook" 
clearBuffer() 
timeOut = time.time() 
while True: 
StartTime = time.time() 
while not playing: 
checkForEvent( ) 
pressed = getPins() 
if pressed: 
timeOut = time.time() 
for pin in range(@,len(sensorPins)): 
if currentPin[pin] == @ and lastPin[pin] != 0: 
if time.time() - lastEntry > debounceTime or 
lastInstrument != pin: 
drums[pin].play() 
placeInBuffer (pin, time. time() ) 
lastInstrument != pin 
lastPin[pin] = currentPin|[ pin | 
if time.time() > (timeOut + startDelay): 
playing = True # start playing if nothing received 
delay = time.time()-startTime # length of sequence 
adjustBuffer(delay) # add delay into buffer 
while playing : 
checkForEvent( ) 
lookAtBuffer (delay) 
pressed = getPins() 
if pressed: 
playing=False 
clearBuffer() 


raspberrypi.org/magpi 


aD . 
eS. 
54. 
 . 
56. 
a rue 
58. 
Shoes 
60. 
ol. 
62. 
63. 
64. 
65. 


66. 
6/. 
68. 
69. 
ie. 
THe 
TPS 
am 
74. 
pase 
7D. 
v6 
7S . 
ZO. 
80. 
81. 
82. 
83. 
34. 
85. 
86. 
8/7. 
88. 
oo, 
=) 6 
> ME 
BP. 
B54 
94. 


eye 
168 
i EP 
23. 
ED. 


100. 
1 . 


102. 


# see if something needs sounding 
def lookAtBuffer(delay): 
global event, instrument, ledOn 
for i in range(@,bufferLength) : 


if instrument[i] != -1 and time.time() >= event[i]: 


toPlay = instrument[i | 

drums[toPlay].play() 

io.digitalWrite(ledPins[toPlay],1) # turn on LED 

ledOn[toPlay] = time.time() 

instrument[i] = -1 

placeInBuffer(toPlay, time.time( )+delay) 
for i in range(@,len(ledPins) ): 

if ledOn[i] != @ and time.time() > ( 
ledOn[i]+debounceTime) : 
io.digitalWrite(ledPins[i],0) 
ledOn[i] = 0.0 


def adjustBuffer(delay): # add delay into buffer 
global event, instrument 
for i in range(@,bufferLength): 
if instrument[i] != -1: 
event[i] += delay 


def clearBuffer(): 
global instrument,event, lastInstrument, lastEnrty 
lastInstrument = -1 
lastEnrty = 0.0 
for i in range(@,bufferLength): 
instrument[i] = -1 
event[i] = 0.0 


def getPins(): 
down = False 
for pin in range (@,len(sensorPins) ): 
currentPin[pin] = io.digitalRead(sensorPins[pin]) 
if currentPin[pin] == 
down = True 
return down 


def placeInBuffer(drum, strikeTime): 

global event, instrument, lastEntry, lastInstrument 

place = @ # find free space 

while instrument[place] !=-1 and place < 
bufferLength-1 : 

place+=1 

event[place] = strikeTime 

instrument[place] = drum 

lastEntry = strikeTime 


def initResource(): 

global sensorPins,samples, drums, currentPin, lastPin, 
event, instrument, ledPins 

sensorPins= [20,15,12,7,24] # GPIO pins for sensors 
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DRUM LIKE ME 


>PYTHON 2 


DOWNLOAD: 
magpi.cc/1NqJjmV 


ledPins = [16,14,21,8, 23] 
# GPIO pins for the LEDs 


samples = [ "clap.wav", 
W ‘ W Uy : VIDEOS 
top.wav", "ride.wav" | 

drums = [ pygame.mixer. Check out Mike's 


Bakery videos at: 
magpi.cc/1NqJnTz 


Sound("sounds/"+samples[ sound ]) 
for sound in range(Q, 
len(sensorPins))]: 
currentPin = [1 for pin in range( 
@, len(sensorPins)) | 
lastPin = [1 for pin in range(@, len(sensorPins) ) ] 
event = [ time.time() for b in range( 
Q,bufferLength) | 
instrument = [ 1 for b in range(@,bufferLength) | 
Eee: 
io.wiringPiSetupGpio( ) 
except ; 
print"start IDLE with ‘gksudo idle’ on command 
line" 
os. exit(1) 
for pin in range (@,len(sensorPins) ): 
# make pin into an input 
i10.pinMode(sensorPins|[pin],2@) 
# enable pull up 
io.pullUpDnControl(sensorPins[ pin], 2) 
for pin in range (@,len(ledPins)): 
# make pin into an output 
io0.pinMode(ledPins[pin],1) 
io.digitalWrite(ledPins[pin],@) # set output low 


def terminate(): # close down the program 
pygame.mixer.guit() 3; pygame.quit() 
for pin in range (@,len(ledPins)): 
io.digitalwWrite(ledPins[pin],@) # turn LEDs off 
os. exit(1) 


def checkForEvent(): # keyboard commands 
global playing 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ ESCAPE : 
terminate() 
if event.key == pygame.K SPACE : 
playing = False 
clearBuffer() 


# Main program logic: 
if — name == | 
main() 


Samabn 
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Former IT consultant. Has enjoyed 
playing with Unix and Linux for many 
years. Received a Raspberry Piasa 
Christmas present a few years back. 


Bit 


a 
idm 


YOUR RASPBERRY PI 2 


Use ‘Das U-Boot’ to boot multiple Raspberry Pi operating systems 


> Das U-Boot: 
magpi.cc/ 
2iZ7P8g 


> Cross-compiler 
tools 


from a USB hard drive 


ast time we looked at multi-booting (in 

issue 52), we got ourselves set up to start 

putting several operating systems and Linux 
distributions on the Raspberry Pi in a multi-booting 
scenario. Let’s finish that off... 

The following distributions have been tested as 
working: Raspbian, Ubuntu MATE, SUSE, Manjaro, 
Fedora 25, Puppy Linux, Sabayon, and Arch Linux 
in console mode. 

The concept of booting multiple operating systems 
from one USB hard disk using one kernel is not 
without its problems. 

Firstly, you need a fast USB disk that connects 
directly to the Raspberry Pi, which means it’s 
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far preferable to use an external hard drive that 
has its own power supply. 

The separation between partition 1 (/boot) and 
partition 2 (root file system) is not defined exactly. 
Debian-based distributions seem to adhere to similar 
Standards, but other distributions do not, most 
notably Fedora 25 (download at magpi.cc/2igrnGp) 
and Manjaro (magpi.cc/2j5gc4w). 

Whichever distribution you have downloaded, it 
is wise to install it on a micro SD card first and boot 
it for the first few times from the SD card. This is 
because some distributions run through some initial 
steps like creating a new user for you and doing 
other customisations. 
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After these steps have been completed and you are 
happy with the resulting distribution, you can copy 
the root file system onto your USB disk. When you 
create new partitions on your USB disk, make sure 
they are created as ext3 partitions, since the U-Boot 
disk does not play well with ext4 partitions yet. 


Modify in C 
The U-Boot code can be extended with your own 
custom commands. The only way you can make full 
usage of all the built-in features of U-Boot is to 
generate anew command as part of it, which should 
then be linked into the newly created executable 
u-boot.bin. The most convenient place to put your 
new source code is in the cmd subdirectory of U-Boot. 
After having done this, modify the Makefile in the 
cmd directory to add your code to be compiled and 
linked into the U-Boot. Once you have transferred the 
resulting u-boot.bin file to the first partition of the 
SD card, as described in part one of this series in issue 
52, you can test your modifications by hand. Interrupt 
the U-Boot sequence and type in the newly created 
command; in our example, this is called wp1_cmd. 
Create the executable file by issuing make all in the 
top-level directory of the source code tree of the 
downloaded U-Boot. 

At the very end of cmd/Makefile, you need to add 
the following line: 


obj-y += new_wpl _all.c 


...where new_wpl_all.c is the C file name of your 
extension code. Add a custom boot.scr file to your 
/boot partition by issuing the command in the top- 
level directory of the source code tree: 


./tools/mkimage -O linux -A arm -T script -n 
“boot script for booting from usb hard disk" 
-d wpl_prerate.txt boot.scr 


Source of the code 

After including the normal C header files, some 
U-Boot-specific headers will be included to allow 
access to the file-system-specific routines and other 
bits of the U-Boot. 

Specific to this command is os_list, which contains 
the names of the partitions and the OS path to the 
partitions. 

Once the source code has been compiled 
successfully, it has to be transferred to the /boot 
partition of the micro SD card. This can easily be 
achieved on a Linux based system — the one which 
does the compilation and linking steps of the 
U-Boot. Mount the micro SD card on your Linux 
system, and issue a copy command: 


cp -p u-boot.bin boot.scr / 
media/<userid>/<boot-partition-name>/ 
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MULTI BOOT ON A RASPBERRY PI 2 


late-ThinkPad-TS10: ~ 


2 wPplapper@M 
File Edit View Search Terminal Help 


Invalid selection, please try again ... 
Select an Operating System to boot ... 


DOWNLOAD: 
magpi.cc/MultiBoot2 


1 Mate-1604-LTS 
2 Mate-1604 
3 Suse 
4 Puppy 
5 Fedora 
6 Manjaro 
Enter selection number ... 


Invalid selection, please try again ... 
Select an Operating System to boot ... 


1 Mate-1604-LTS 
2 Mate-1604 

3 Suse 

4 Puppy 


5 Fedora 
6 Manjaro 


Enter selection number ... 


Booting in 7 seconds 


Above If you 
follow the tutorial 
correctly, you 
should get a boot 
menu similar 

to this 


...where ‘userid’ is your own user ID and ‘boot- 
partition-name’ is the name of the boot partition 
of the SD card. 


Post-processing 

These are a couple of tasks to be done on the 
Raspberry Pi before you boot from the USB hard disk. 
Firstly, modify the /etc/fstab file of the distribution to 
match the real root file system: 


/dev/sda<x> / ext4 defaults,noatime,nodiratime, 
errors=remount-ro @ 1 


This should replace /dev/mmcb1k@p<y> / ext4 ... 

Next, copy all /lib/modules/S(uname -r)/ from 
the distribution where the kernel came from originally 
to the distribution’s lib/modules/S(uname -r)/ via 
rsync. This step has to be repeated every time the 
kernel gets updated via rpi-update or implicitly by 
updating your packages via the package manager. 
Watch out and don’t get caught without a complete 
backup of your /boot file system: 


rsync -av /lib/modules/$(uname -r)/ / 
media/<userid>/<Distribution-name>/1lib/ 
modules/$(uname -r)/ 


If you forget this step, you might be able to boot 
your distribution from the USB disk, but the chances 
are very high that you won’t be able to use a keyboard 
and mouse attached to the Raspberry Pi. The drivers 
just don’t match the kernel or the hardware is simply 
not recognised properly. 

In summary, U-Boot can be used to boot multiple 
partitions from one USB hard disk. This project is 
not without its problems, since there can only be 
one kernel, which lives in the /boot partition of the 
micro SD card. Different distributions have different 
requirements from the Kernel. The other issue which 
has been observed is the dependency of the systemd 
service on the kernel. 
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))) Sonic Pi 


ADDITIVE 
SYNTHESIS 


Did you know you can design sounds on Sonic Pi? Sam Aaron shows us how... 


Raspberry Pi 
aUlalaliavemacstsjele)iclal 


Sonic Pi v2.9+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


his is the first of a short series of articles 
on how to use Sonic Pi for sound design. 
We’ll be take a quick tour of a number of 
different techniques available for you to craft your 
own unique sound. 

The first technique we’ll look at is called additive 
synthesis. This may sound complicated - but if 
we expand each word slightly, the meaning pops 
right out. Firstly, ‘additive’ means a combination 
of things; secondly, ‘synthesis’ means to combine 
thing, in this case sounds. Additive synthesis 
therefore means nothing more complicated than 
combining existing sounds to create new ones. 

This synthesis technique dates back a very long 
time — for example, pipe organs in the Middle Ages 
had lots of slightly different-sounding pipes which 
you could enable or disable with stops. Pulling out the 
stop for a given pipe ‘added it to the mix’, making the 
sound richer and more complex. Now, let’s see how 
we can pull out all the stops with Sonic Pi. 


Simple combinations 
Let’s start with the most basic sound there is — the 
humble pure-toned sine wave: 


synth :sine, note: :d3 


Now, let’s see how this sounds combined with 
a square wave: 


synth :sine, note: :d3 
synth :square, note: :d3 


Notice how the two sounds combine to form a new, 
richer sound. Of course, we don’t have to stop there: 
we can add as many sounds as we need. However, 
we need to be careful with how many sounds we 
add together. Just like when we mix paints to create 
new colours, adding too many colours will result in 
a messy brown. Similarly, adding too many sounds 
together will result in a muddy sound. 
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Blending 

Let’s add something to make it sound a little brighter. 
We could use a triangle wave at an octave higher (for that 
high bright sound), yet only play it at amp @.4 so it adds 
something extra to the sound rather than taking it over: 


synth :sine, note: :d3 
synth :square, note: :d3 
synth :tri, note: :d4, amp: 0.4 


Now, you can try creating your own sounds by 
combining two or more synths at different octaves and 
amplitudes. Also, note that you can play around with 
a synth’s opts to modify each source sound before it is 
mixed in for even more combinations of sounds. 


Detuning 

So far, when combining our different synths we’ve 
used either the same pitch or switched octave. How 
might it sound if we didn’t stick to octaves but instead 
chose a slightly higher or lower note? Let’s try it: 


detune = Q.7 
synth :square, note: :e3 
synth :square, note: :e3 + detune 


If we detune our square waves by 0.7 notes, we 
hear something that perhaps doesn’t sound in tune 
or correct — a ‘bad’ note. However, as we move 
closer to O, it will sound less and less out of tune as the 
pitch of two waves gets closer and more similar. Try it 
for yourself! Change the detune: opt value from @.7 to 
@.5 and listen to the new sound. Try @.2, 0.1, 8.05, @. 
Each time you change the value, take a listen and see if 
you can hear how the sound is changing. Notice that low 
detune values such as @.1 produce a really nice ‘thick’ 
sound, with both slightly different pitches interacting 
with each other in interesting, often surprising, ways. 
Some of the built-in synths already include a detune 
option that do exactly this in one synth. Try playing with 
the detune: opt of :dsaw, :dpulse, and :dtri. 
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INN 


=> Studio: Resuming SuperCollider audio server 


use_synth_defaults sustain: 8, amp: 3 => Starting run 2 
synth :saw, note: :e4, pan: -] {run: 2, time: 0.0} 
synth :saw, {amp: 3, sustain: 8.0, pan: -1, note: 64.0} 


synth :Saw, note: seZ, pan: J E synth :saw, {amp: 3, sustain: 8.0, pan: 1, note: 40.0} 
synth :Square note: -e5 amp : fi) 7 synth -Square, {amp: 0.7, sustain: 8.9, note: 76,0} 
. - - . 5 . } « 


\ButferO Butter? Buffer2 Buffer3 Buffer4 Buffer Buffer 6 
xo 


1 Welcome to Sonic Pi 

1.1 Live Coding 

1.2 Exploring the Interface 

1.3 Learning through Play 
2 Synths Left Combine 

2.1 Your First Beeps gyrate ae sounds to make 
new ones with 
additive synthesis 


Amplitude shaping couple of low sine waves to give the sound some bass 
Another way in which we can finely craft our sound is and depth. Finally, we use define to wrap our code ina 
to use a different envelope and options foreach synth = function which we can then use to play a melody. Try 
trigger. For example, this will allow you to make some __ playing your own melody and also messing around with 
aspects of the sound percussive and other aspects ring thecontents of the :bell function until you create 

out for a period of time. your own crazy sound to play with! 


# Triangle waves for the ‘hit?’ 


# Sine waves for the ‘ringing’ 
In the example above, we have mixed in a noisy 
percussive element to the sound along with some 
more persistent background rumbling. This was 
achieved firstly by using two noise synths with 
middling cutoff values (96 and 10), using short 
release times, along with a noise with a longer release 
time but with a low cutoff value (which makes the # Low sine waves for the bass 
noise less crisp and more rumbly. ) 


Bringing it all together 

Let’s combine all these techniques to see if we can 
use additive synthesis to recreate a basic bell sound. # Play a melody with our new bell! 
We’ve broken this example into four sections. Firstly 
we have the ‘hit’ section, which is the initial onset 
part of the bell sound, and so uses a short envelope 
(e.g. arelease: of around @.1). Next we have the 
long ringing section, for which we’re using the pure 
sound of the sine wave. Notice that we’re often 
increasing the note by roughly 12 and 24, which is the 
number of notes in an octave. We’ve also thrown ina 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


WIRELESS 
CONNECTIVITY 
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Right That's 
the wireless 
antenna. 

It's tiny! 


Wireless LAN 

You can connect to a wireless network (WiFi) using 
the on-board wireless LAN on the Raspberry Pi 3. 

For other Raspberry Pi models, you can buy a WiFi 
dongle; most work just fine on it and can be managed 
from the graphical interface. 


Bluetooth 

As well as wireless LAN, the Raspberry Pi 3 has 
built-in Bluetooth connectivity. You can connect 
speakers and input devices to the Raspberry Pi via 
Bluetooth, although you may have a bit of trouble 
navigating a mobile phone’s storage. 


Radio 

While no Raspberry Pi supports native RF radio, 
there are some HATs, add-ons, and USB devices 
you can plug into it that add support for this. You’ ll 
need to refer to any documentation on the device to 
clarify how to get it work on the Pi. 
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NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


< 


Check your SSID 

Make sure that you know the SSID and password for 
the wireless network you want to connect to. Turn 
on the Raspberry Pi (with a WiFi dongle plugged in 
if you need to use one) and boot into the graphical 
desktop interface. 


Connect to the network 

In the top right of the screen you’|I notice the wireless 
interface logo — a dot below quarter-circles. Click on 
it and search for your network name. Click on the 
network and enter your password. It should then 
connect and give you internet access. 


Command line 

If you’ve connected to the network on the graphical 
interface, the Pi will remember these details even if 
you boot to the command line. If you need to set it up 
via the command line, though, a guide can be found 
here: magpi.cc/2hQhwW4. 


Make it discoverable 

All Bluetooth devices have a way to make themselves 
discoverable by other Bluetooth devices — refer to the 
device’s manual on how to do this. It usually involves 
holding down the main button for a period of time. 


Find it 

On the Raspberry Pi graphical desktop, look for the 
Bluetooth logo in the top right. Click on that and begin 
scanning for devices to pair with. Click the one you 
want and enter a passcode if you set one up. 


Command line 

Pairing in the command line is rather tricky. It’s better 
to do it via the desktop as most uses of Bluetooth with 
the Pi only work on the desktop anyway. There are 
some threads in the Raspberry Pi forums with some 
solutions on how to do it, though. 
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DOES THE RASPBERRY PI COME WITH A CASE? 

An official case for the Raspberry Pi is available from various 
retailers. There are also lots of homebrew case discussions on 
the forum, as well as several third-party cases available. We 
suggest stopping by the cases subforum and reading some of 
the threads about cases you can purchase or build yourself. 


CAN | POWER THE RASPBERRY PI FROM A USB HUB? 

It depends on the hub. Some hubs comply with the USB 
2.0 standard and only provide 500mA per port, which may 
not be enough to power your Raspberry Pi. Other hubs view 
the USB standards more like guidelines, and will provide 
as much power as you want from each port. Please also 

be aware that some hubs have been known to ‘backfeed' 
the Raspberry Pi. This means that the hubs will power the 
Raspberry Pi through its USB input cable, without the need 
for a separate micro-USB power cable, and bypass the 
voltage protection. If you are using a hub that backfeeds to 
the Raspberry Pi and the hub experiences a power surge, 
your Raspberry Pi could potentially be damaged. 


TAKE GIANT 


CAN | POWER THE RASPBERRY PI FROM BATTERIES 

AS WELL AS FROM A WALL SOCKET? 

Running the Raspberry Pi directly from batteries 
requires special care and can result in damaging or 
destroying your Raspberry Pi. If you consider yourself 
an advanced user, though, you could have a go. For 
example, 4xAA rechargeable batteries would provide 
4.8V ona full charge. 4.8V would technically be just 
within the range of tolerance for the Raspberry Pi, but 
the system would quickly become unstable as the 
batteries lost their full charge. Conversely, using 4xAA 
Alkaline (non-rechargeable) batteries will result in 6V; 
this is outside the acceptable tolerance range and 
would potentially damage or, in the worst case scenario, 
destroy your Raspberry Pi. It is possible to provide a 
steady 5V from batteries by using a buck and/or boost 
circuit, or by using a charger pack which is specifically 
designed to output a steady 5V from a couple of 
batteries; these devices are typically marketed as 
mobile phone emergency battery chargers. 


LEAPS FORWARD 


Great gadgets for your next Raspberry Pi projects 
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RASPBERRY Pi 


Compact way to easily integrate a Combines with Raspberry Pi Compute Provides onboard computing capabilities 
Raspberry Pi Compute Module* with a Module* to quickly turn a TV or monitor with an included Pi Zero for autonomous 
USB drive to create projects like a into a powerful media hub or custom projects like video recording, data 


wireless NAS or USB camera recorder. 


*Raspberrry Pi Compute Module not included. 
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*Raspberrry Pi Compute Module not included. 


digital display. logging, and more. 
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feature 


UNDERSTAND 


OBJECT- 


ORIENTED 
PROGRAMMING 


Get your head around OOP by using Scratch and Python to create the same programs 
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UNDERSTAND OBJECT-ORIENTED PROGRAMMING 


n the modern world, almost all of the 
code you will encounter is created 

in a style called ‘object-oriented 
programming’, or OOP for short. 

If you grew up with OOP, it is the obvious 
way to create computer programs. 

IMNOOP tie cede is lisedile crear ob)|cets. 
These represent real-world things: a dog, a 
chair, or the wheels on a car. 

Objects contain both the variables that 
make that thing: a person’s height, age, or 
a name for example. They also contain the 
functions that object can perform: a dog can 
jump, or walk, or run; a wheel can rotate. 

OOP bundles both the variables and 
functions together. This style makes it 
Super-easy to cut and paste the code from one 
program to another. You don’t even need to cut 
and paste, in fact: you use import statements to 
get functions and the variables they need. 

With OOP, you don’t need to create an object for 
a dog: you just find one somebody else has made 
and import it to your program. 


Importing knowledge 

At the start of most programs, you’ll find a bunch of 
import statements. These are used to paste in code 
which has been created by other people. 


OOP isn’t perfect. It can be accused of overkill. “The 
problem with object-oriented languages is they’ve got 


all this implicit environment that they carry around 
with them,” says Joe Armstrong, creator of Erlang. 
“You wanted a banana but what you got was a gorilla 
holding the banana, and the entire jungle.” 

There’s also a whole bunch of decorative 
terminology surrounding OOP. You’1l encounter 
lots of strange words like ‘encapsulation’ and 
‘instantiation’. These make the concept appear much 
more complicated than it is, and can also be rather 
off-putting to newcomers. 

So OOP is a bit wordy and lends itself to navel- 
gazing. Many makers, hackers, and coders struggle to 
understand OOP, and indeed you can get a long way 
without understanding it. 

Young coders, on the other hand, are increasingly 
introduced to programming via Scratch. 

Software like Scratch is included with Raspbian 
with PIXEL (and Debian with PIXEL) and is designed 
specifically to teach students OOP stealthily. 

In Scratch, objects are called ‘Sprites’. They 
resemble video game characters. The idea is that 
children brought up on Scratch will inherently 
feel at home with objects when they migrate toa 
language like Python. 
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PROCEDURE 


When you first start programming, you'll begin by 
writing procedural code. 

In good old-fashioned procedural programming, 
you typically create all your variables at the start of a 
program. Then you make some function definitions 
(these are blocks of reusable code). 

We looked at procedural programming in The MagPi 
issue 53 (magpi.cc/2iin6PQ). 

OOP takes all the building blocks of procedural 
programming - variables, functions, loops, conditions — 
but bundles them into self-contained blocks. 

Most coders create procedural scripts that import 
objects (from modules and packages). So you're using 
objects without even realising it. 

OOP concepts are found in almost all modern 
programming languages, including Python and Java. 
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CREATE 
INS! 


Create a game in Scratch where players play 
dice with one another 


Raspbian 
with PIXEL 


Scratch 2.0 
account 


irst, we’re going to create a game in 
Scratch. Then we’ll recreate it in Python so 
you can see how it works in both languages. 

Our dice game is based on Bunco 
(magpi.cc/2hoZNcj). It’s a popular parlour game 
played in North America. 

We’ve made the rules a little simpler. Each player 
rolls three dice and counts up the score. The player 
with the highest score wins. 

We need two players, each with their own set 
of dice. Each player then rolls the dice, looks at 
their dice, and compares them with the dice of 
the other player. 

If they have the same score, both call it a draw. 
If a player spots that their total is higher than the 
other person’s, they shout out “I win!”’. 

This game introduces you to the concept 
of local variables. Each sprite has three local 
variables: their own set of dice. They can also 
look at the variables (or dice) that are local to 
other sprites. 

The opposite of a local variable is a global 
variable. This is as if both players rolled a single set 
of dice and shared the result. They’d always draw. 

Scratch works slightly differently to Python. 

In Scratch, you create one sprite and then clone 
(duplicate) it to create a second sprite. In Python, 
you create a blueprint for your sprites (known as 
a ‘class’) and then stamp out two player objects. 
We'll come to Python in a bit. 

Let’s create the dice game in Scratch first... 
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Bunco on Scratch * 
€ CC @ bittps://scratch.mit_edu’projects/1 37 524930/ #eaitor 


sonAT cH G fies Edti~ Tips About 


Teg) [Bunce 
a 7 
oct _ by lucyhattersley (unshared) a 


fa? Yi te @ 


x 
New sprite; @ J Make w test 


Backpack 


Scratch 
Open the web browser and visit scratch.mit.edu to 


open Scratch 2.0. We need the clone features from 
2.0, so don’t use the Scratch 1.4 app. Log in (or create 
an account if you’re new to Scratch). Create a new 
project and you’ll see a single Scratch Cat sprite on the 
screen. Click the ‘i’ symbol next to the sprite in the 
bottom-left. Change its name to Player1. 


>STEP-02 


Three dice 

Click on Data and then Make a Variable. Enter dice1 
in the Variable name field and select ‘For this sprite 
only’. Click OK and dice1 appears in the blocks 
palette. Repeat the process to create dice2 and dice3. 
Finally, create another variable called total. 
Remember to choose ‘For this sprite only’ for all 
meee Gee ainal vowel, 
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' © Bunco on Scratch x \. ry 


>STEP-05 


Compare scores 


co C | & bitps //scratch.mit.edu/projects/ 137354930) #edeor bat |a G t 
> 


Tee | Bunce 
& by bucyhattersisy (unshared! » 


ee oe e ° We’ve only got one sprite so far. But we’re about to 
Ls j= r add another and compare one sprite’s total with the 
poe other. Choose the Sensing selection of blocks and 


look for one marked x-position of Player1. Change 
‘x-position’ to total. Drag the block into the correct 
side of the greater-than block. 


(x4 


© For allsprtes @ For this sprte onl 


—— 


Backpack 


set cei Aa ick random @ to @ 
>STEP-03 Set) dice? to pick random @ to@ 
Throw the dice dens 


Click on Events and drag a when green flag clicked 

block to the scripts area. Below this you need to 

add three set diceN to pick random 1 to 6 blocks. 

Below these blocks, add set total to dice1 + dice2 > total of Player! 
+ dice3 (you need to drag one () + () block inside 

another to add up three blocks. 


0 
0 


| ——_ 
\ = 
é j bd ~ 
when * clicked 
4 { 1° a . —_ 

ee eee —" ae 
.. = a 
—~_ 


dicel pick random @to@ Fe 
dicez— — 


— -0 
pick random @} to @ | 
¥ pick random @) to 6 | 


(ae 


>STEP-06 

Player 2 

Our Player 1 is ready. Now we’re going to clone the sprite 
to create a Player 2. Right-click the sprite and choose 
Duplicate. The new cat sprite will be automatically called 
‘Player2’. Click on Player1 in the Sprites window. Change 
the total of Player1 block to total of Player2 (as shown 
below). Now Player1 compares their total to Player2 (and 
Player2 is comparing theirs to Player1). Click the green 
flag to run the program and see which player wins. 


>STEP-04 


Speak (/ + Banco on Scratch » Wh = | 8) 


€ ce https://seratch mitedu projects TITS24320/# ecittor 


Now drag a Say for block and attach it to the end of 
the code. Change it to say total for 1 secs. Below 
that, drag an if block. Inside, add a [] > [] (greater- 
than) block. Drag the total variable to the left side of 
the greater-than block. Drag a say block inside the if & is 
block and change ‘Hello!’ to ‘I win’. 


_ clicked se 


0 
, 0 


ficel o 
diced pick random @} to @ 


‘dicel + dice2 + dice3_ 


The concept of scope is important in object-oriented programming. In Scratch, it's 
so simple that you may not even notice it. But our two players each have their own 
dice1, dice2, and dice3 variables, plus a total variable. These variables are local in 


scope. When Player1 announces total, it’s their total. If both sprites accessed the 
same total, it would be global in scope. Variables in objects are local in scope. 
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CREATE BUNCO 
IN PYTHON 


CLASS 
AND INSTANCE 


One of the biggest differences between creating sprites in Scratch and 
objects in Python is that you create an object using a class. This code acts 
as a blueprint for the object. 

In Scratch, you create a sprite and then duplicate it. The second sprite has 
the same functions as the first. It also has its own set of variables. 

In Python (and other programming languages), things work somewhat 
differently. You don't create an object directly. Instead, you create a blueprint 
for the objects. This blueprint is known as the ‘class: Don't think of a school, 
though. Class here means a category of similar items. It's rather like a ‘Class M 
planet in Star Trek: though different, these are all Earth-like planets. 

Once you've created your class, you use it to create objects. 

These are known as ‘instances’ or ‘object instances’ They all share 
similar properties. They all have the same variables and functions 
(called ‘methods’). In Scratch, we create one sprite and then duplicate 
it (to get two sprites). In Python, we create one class definition. We then 
use this to create two object instances. 
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Recreate our game of Bunco in Python 


ur basic version of Bunco runs just fine in 
Scratch. Now we’re going to recreate it in 
Python. The translation will help us get a good 
understanding of how objects work. 

First, think about how we could make the 
game procedurally. 

There is a module called random that we can import 
to create random numbers. So we’d need to import 
that. Then we could create a list for each player. 

And use the randint function to add three random 
numbers between one and Six. 

We could then use an if else block with the sum() 
function to add up each player’s numbers. The player 
with the highest score wins. 

Type out the code from bunco_procedural.py to test 
the program. 

There are two problems with this procedural. 
Bunco is a much more complex game in real life. 

It is played in six rounds, and players score 21 points 
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if they roll all three dice that match the number of {a ' g 
the round (three 1s in round 1, or three 2s in round 2, b ocedural >PYTHON 
and so on). That’s known as rolling a ‘bunco’. unco_pr -PYy 


We’re not going to create all that complexity here. DOWNLOAD: 
But we are going to add extra types of player. Cheats! import random MaOPICC/2XEOW. 
One scoundrel has loaded dice; the other rapscallion 
Swaps out one die for a Six. player1 dice = [] 

We’re then going to play thousands of games and player2_dice = [] 
see who wins. 

This complexity would be extremely difficult in for i in range(3): 
procedural programming. It requires us to rethink our player1_dice.append(random.randint(1,6)) 
approach to Bunco. And OOP is the answer. player2_dice.append(random.randint(1,6)) 

OOPs upside your head print("Player 1 rolled" + str(player1_dice)) 


print("Player 2 rolled" + str(player2_dice) ) 


Instead of creating a list of variables for each player at 


the start, we’re going to create a class called Player. if sum(player1 dice) == sum(player2_ dice): 
The code in bunco_oop.py represents a dice player. print( "Draw" ) 
We then use it to create two players (see ‘Class elif sum(player1_dice) > sum(player2_ dice): 
and Instance’). print("Player 1 wins") 
As with our procedural code, we start by importing else: 
the randint module. print("Player 2 wins") 


Now we define our player objects. To do this, 
we create a class definition. It looks like this: 


class Player: bunco_ocop.py 


Inside the class definition is indented code that from random import randint 
describes the player object. 
Notice that the class name is capitalised and, unlike class Player: 
function definitions, there are no parentheses. def _init (self): 
The first thing we need to add is a list to contain the self.dice = [] 
dice. Normally this would be just dice = []. But if we 
wrote it like this: def roll(self): 
self.dice = [] # clears current dice 
Class Player: for i in range(3): 
dice = [] self.dice.append(randint(1,6) ) 
...we’d have a problem. This code is equivalent to def get dice(self): 
choosing ‘For all sprites’ in Scratch. Every player return self.dice 
created using this code would share a single set of 
dice and get the same results. We want to use the player1 = Player() 
equivalent of ‘For this sprite only’. player2 = Player() 
To ensure that all our players have their own set of 
dice, we need to wrap the dice = [] list inside a quirky playeri1.roll() 
function called __init__(). player2.roll1() 


It looks like this: 
print("Player 1 rolled" + str(player1.get_dice())) 


class Player: print("Player 2 rolled" + str(player2.get_dice())) 
def init _ (self): 
self.dice = [] if sum(playeri1.get_dice()) == sum(player2.get_dice()): 
print("Draw!") 

The __init__() function runs when you use a class elif sum(player1.get dice()) > sum(player2.get_dice()): 
to create an object. print("Player 1 wins!") 

This is known as a ‘constructor’ or ‘initialiser’. else: 

Later on, when we use this Player class to create print( "Player 2 wins!") 


player objects, the ___init__() code runs each time 
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automatically. It creates a separate set of dice for each of An object’s functions are called ‘methods’, but they 


our players. are created in the same way. 

The ‘self’ bit also needs explaining. Variables, like There are lots of different types of methods, and you 
our dice = [] list are normally disposed of when a can create whatever you like, but common ones are 
function ends (or is returned). called ‘setters’ and ‘getters’. 

So if we just put dice = [], the list would be created Our roll method is a ‘setter’. It sets the dice list to 
by __init__(), then immediately vanish. three random numbers. 

Python gets around this problem using the keyword What do you think a ‘getter’ does? That’s right. It 
‘self’. You put ‘self’ inside the parentheses of the gets the variables inside the object and returns them. 
__init_ (): We have just the one getter: 

def init (self) def get_dice(self): 


return self.dice 
Then we use self, followed by a dot, to store the 


variable in this version of the object. Getters and setters seem a bit odd at first. After 
all, you could just reach into an object and access 
self.dice = [] the variables. 
Well, you could, at least in Python, but this is 
You then use self. in functions when you want to considered a bad thing to do. One of the points of OOP 
access or change a variable, by writing self insidethe _ is that objects contain their variables and keep them 
parentheses of the function. Like this: safe from other objects. So you don’t just reach inside 
an object and access variables. 
def roll(self): Instead, you create methods (functions) that set the 
variables and get them. Then you use these methods 
The concept can be mind-boggling (it’s passing a to set and get variables. 
version of itself into itself). So focus on the practical Now we’ ve created our class definition, we can use it 
steps rather than the esoteric theory of how it works: to create objects. 
e Put aspecial function at the start of a class called 
° Put the variables you want to use inside init. You create objects just as you would a variable. You 
use the assigns operator (=). We’re going to create two 
° Create the variables with self., like self.name dice players: 
or self.age or self.dice = []. 
playeri = Player() 
° Place self inside the parentheses of functions that player2 = Player() 


need to access the variables. 
Note that player1 and player2 are not called 


° Use self. and the name of the variable inside ‘variables’. They are called ‘object instances’. 
the function to use it. We access the object instance’s methods using dot 
notation. That is where you use the name of the object 
Got that? Don’t worry too much if it seems weird. instance, followed by a dot, then the name of the 
That’s the hardest part and it will get easier with practice. method you want to use. 
Now we’ ve got our dice list sorted, what about the We created a method, get_dice(), that returns 
other functions? the dice stored. We would access this method using 


: dot notation, such as playeri1.get_dice(). 
Methods in the madness First, we use the roll method to get each player 


object to roll its dice: 


Now that our class has a list for the dice, we need 


to roll the dice. For that, we’ll create a more regular player1.rol1l1() 
function definition. player2.roll1() 
def roll(self): The rest of our bunco_oop.py program is really 
dice = [] # clears any current dice very similar to bunco_procedural.py. The difference 
for i in range(3): is that here we use the .get_dice() method in 
self .dice.append(randint(1,6) ) place of sum(). 
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Inheritance cheats 


We’ve already mentioned that one advantage of OOP 
is that we can create hundreds or thousands of players 
with their own set of variables. 

There’s little point in our program as it is, as 
the players are all using the same dice and have the 
same chance of winning. What would happen if we 
introduced some cheats? 

We’re going to create a cheat who swaps out one die 
for a Six, The blighter. 

Our cheat is not alone. We have another one who 
uses three loaded dice. They always roll one higher 
(unless they’re already a six). 

Both cheats would beat a regular player over a few 
hundred games. But which of the cheats would win 
against the other? 

It’s pretty close. To find out the answer, we’ll 
need to run a Simulation that plays hundreds of 
thousands of games. 

We’re going to create our cheats using a technique 
called inheritance. This technique is where you create 


But which cheat 
would win against 
the other? 


a class that takes on all the properties (instance 
variables and methods) of another class. It also adds 
a few of its own. 

Think of a child inheriting its parents’ features. 

It might get its dad’s big nose but grow knobbly knees 
all by itself. 

Our cheats will inherit the same dice and roll 
functions as the parent, but they will have cheat 
functions all of their own. 

Our bunco_module.py program defines the 
Player() class and two children: 


class Player: 
class Cheat_Swapper(Player): 
class Cheat_Loaded_ Dice(Player): 


-bunco_module.py 


from random import randint 


class Player: 
def init (self): 
self.dice = [] 


def roll(self): 
self.dice = [] # clears current dice 
for i in range(3): 
self.dice.append(randint(1,6)) 


def get dice(self): 
return self.dice 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


class Cheat_Loaded Dice(Player): 
def cheat(self): 
sb, 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 


bunco_single_test.py 


from bunco_ module import Player 
from bunco_ module import Cheat_Swapper 
from bunco module import Cheat Loaded Dice 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded Dice() 


cheater1.roll() 
cheater2.roll() 


cheater1.cheat() 
cheater2.cheat() 


print("Cheater 1 rolled" + str(cheater1.get_ dice())) 
Objects that inherit from a parent are defined using print("Cheater 2 rolled" + str(cheater2.get_dice())) 
the same class keyword. 

However, the name of the parent is placed inside 
parentheses of the child. 

Our two cheats inherit all the variables and methods 
(functions) from the parent. So they already have a 
dice list and rol1() and get_dice() methods. 

We now give each cheat an additional method, 
called cheat. This is implemented in a different way 
for each type of cheat. 


if sum(cheater1.get_dice()) == sum(cheater2.get_dice()): 
print("Draw!") 


elif sum(cheater1.get dice()) > sum(cheater2.get_ dice()): 
print("Cheater 1 wins!") 


else: 
print("Cheater 2 wins!") 
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The Cheat_Swapper class definition has a relatively 
straightforward cheat method: 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


Cheat_Swapper’s cheat method finds the last item 
in the dice list and sets it to 6. 

Our Cheat_Loaded_Dice class definition has a 
Slightly more complicated cheat method: 


class Cheat_Loaded_ Dice(Player): 
def cheat(self): 
i= 0 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 


This method iterates through the dice in the list, 
checking whether each die is lower than six. If so, it 
increases its value by one. 

Make sure that you create the code in 
bunco_module.py and save it with the same name. 
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Notice that this code doesn’t have any procedural 
programming below it. This is because we’ re going to 
import it (so you can see what happens when you use 
import in your Python programs). 

Now we will create the code that uses these 
objects in a separate file. Enter the code from the 
bunco_single_test.py listing and make sure you save 
it in the same directory as bunco_module.py. 

The first line imports the Player class definitions 
from our bunco_module.py. 


from bunco_module import Player 


Extra points to you if you spotted that 
bunco_module is listed without the ‘.py’ file 
extension. This is how you import code from other 
files into your program. 

The import Player line pastes in the class Player 
code from bunco_module.py. It’s as if you had 
included that code in your program. 

Compare this line to the from random import 
randint code at the start of bunco_module.py. The 
idea is the same. 

We import the other two class definitions 
we created: 
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from bunco_module import Cheat_Swapper 
from bunco_ module import Cheat_Loaded Dice 


The rest of the bunco_single_test.py code creates 
the same game as our earlier bunco_oop.py program. 

Now we create two object instances using the 
Cheat_Swapper and Cheat_Loaded_Dice definitions 
we imported from bunco_module: 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded_Dice() 


We then use the rol1() method. Notice that 
neither Cheat_Swapper() or Cheat_Loaded_Dice() 
has aroll method definition. This is a function they 
both inherit from their parent class, Player(): 


cheater1.roll1() 
cheater2.rol11() 


Next we call the cheat () method from each 
object instance: 


cheater1.cheat() 
cheater2.cheat() 


Although each object has a method called cheat(), 
the objects have different implementations. So 
cheater1 changes the last die toa 6, and cheater2 
increases each individual die’s value by one. 

Run the program by pressing F5 and see which of 
the players wins. Run it again and you’|I get different 
results. Keep running the program and you’|I find it’s 
a pretty close call. 

Look inside the folder containing the code 
and you’ ll see a new file has appeared called 
bunco_module.pyc. This is a ‘compiled file’ 
and is created the first time you run a program 
that imports code. You don’t usually see compiled 
files because you import code tucked away inside 
Python on your computer. Don’t worry about it. 
You can’t open and make sense of it in a text editor. 
Delete it if you wish. It’ll be recreated when you use 
bunco_module.py in our final program. You can just 
ignore it for now. 

To discover which of the two cheats has the edge, we 
need to run a simulation. We need to play hundreds 
of thousands of games and keep track of who wins 
the games. 

Our final program, bunco_simulation.py, 
does just that. This program brings together 
everything we’ve learned about OOP. The code in 
bunco_simulation.py creates two cheats and plays 
100,000 games. It imports class definitions from our 
bunco_module.py program (so make sure you save it 
in the same folder). 
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bunco_simulation.py 


from bunco_module import * 


Swapper = Cheat_Swapper() 
loaded dice = Cheat_Loaded_ Dice() 


Swapper score = 9 
loaded dice score = @ 


number_of_games = 100000 
game number = @ 


print( "Simulation running") 

print ("s===s====s=s=s==s=====") 

while game_number < number_of_games: 
Swapper.roll() 
loaded_dice.roll() 


Swapper. cheat() 
loaded _dice.cheat() 


#Remove # before print statements to see simulation running 
#Simulation takes approximately one hour to run with print 
#statements or ten seconds with print statements 
#commented out 


#print( "Cheater 1 rolled" + str(swapper.get_dice())) 
#print( "Cheater 2 rolled" + str(loaded dice.get dice())) 


if sum(swapper.get_dice()) == sum(loaded dice.get_ dice()): 
#print( "Draw! ") 
pass 


elif sum(swapper.get dice()) > sum(loaded_dice.get dice()): 
#print("Dice swapper wins!") 
Swapper _score+= 1 

else: 
#print("Loaded dice wins!") 
loaded dice score += 1 


game_number += 1 


print( "Simulation complete") 


d)pillghe(( 4 eee oa ee ae ") 
print("Final scores") 
print(" eg eg pe ay ee ") 


print( "Swapper won: + str(swapper_score)) 
print( "Loaded dice won: " + str(loaded_dice_ score)) 


if swapper_score == loaded _dice_ score: 
print("Game was drawn") 

elif swapper_score > loaded dice score: 
print("Swapper won most games") 

else: 
print("Loaded dice won most games") 
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Waker 
says 


Bring 
your data 


home 
Nextcloud 


NEATCLOUD BOX 


Could a supply-your-own-Pi bare-bones box be your ticket 
to data independence and security? 


WD LABS 
PIDRIVE 
BERRYBOOT 
EDITION 


If you don't need 
the Nextcloud 
software, 

the PiDrive is 
available as 

a standalone 
option direct 
from WD Labs, 


but you'll need to 
buy the case and 


power supply 
separately. 


£58/S60 


wdlabs.wd.com 


he low power draw of 
the Raspberry Pi family 
means they are very 
well suited to always-on server 
applications. A network-attached 
storage (NAS) device is one 
possible use case, but dealing 
with external USB-connected 
hard drives and multiple power 
bricks is an unwelcome side effect 
of rolling your own solution. 
That’s where the Nextcloud 
Box comes in. Created as 
a partnership between storage 
giant Western Digital’s WD Labs 
division and the open-source 
Nextcloud project, the Nextcloud 
Box takes WD Labs’ PiDrive 
and uses it as the home for 
a clever variant of the Nextcloud 
server software. 
Unpacking the box, the first 
thing you’ll notice is that no 
Pi is included. The Nextcloud 
Box comes with a1TB PiDrive 
USB hard drive, clever magnetic 
housing, power splitter cable, 
data cable, mounting screws and 
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screwdriver, a 4GB micro SD card, 
and a power supply capable of 
driving both a Raspberry Pi and 
the hard drive. It’s then up to 
the user to supply the Pi itself; 
at the time of testing, only the 
Raspberry Pi 2 was supported, 
with Pi 3 compatibility promised 
in a free software update which 
should have been released by the 
time this issue hits shelves. 


Cloud setup 
Installation is quick and easy: 
simply fix your Raspberry 
Pi into the casing using the 
provided screws, run the 
cables, and route a network 
cable. The small 4G micro SD 
card is used only for the initial 
boot process, which copies the 
Ubuntu Snappy Core operating 
system onto the 1TB hard 
drive in an entirely automatic 
installation process which takes 
about ten minutes to complete. 
The first surprise with the 
Nextcloud Box is that there’s 


never a need to connect a display 
or keyboard, unless you want 
to. All management is carried 
out using a web interface, bar 

a few advanced tasks which 
require SSH access to the Pi. 
From here, using the Nextcloud 
Box is like using any other 
installation of Nextcloud: user 
accounts, encryption settings, 
and additional features from 
media streaming through to 

a centralised calendar system 
can all be set up and configured 
directly within the browser. 

By default, the Nextcloud Box 
is accessible only from your 
local network, either using the 
browser interface or dedicated 
client software. Configuring 
it for external access is one of 
the few parts of the process 
which could be fairly described 
as inaccessible to less technical 
types: you’ll need to log in via 
SSH, configure a dynamic DNS 
service, run a script which 
retrieves a cryptographic 
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certificate from Let’s Encrypt, 
and set your router up to forward 
port 443 to the Nextcloud Box. 
Assuming you’ve done all 
that, you get encrypted access 
to your data - including two-way 
synchronisation, a great way to 
keep photos and videos from 
your phone safe — anywhere in 
the world with no ongoing costs. 
Performance is, surprisingly, 
very smooth: despite the 
network port and hard drive 
both sharing the Pi’s single USB 
channel, transferring files to 


By default, the Nextcloud Box 
is accessible only from your 


local network 


the Nextcloud Box felt snappy 
with little in the way of annoying 
pauses or hitches. 

If you don’t feel like dedicating 
a Pi to just Nextcloud use, there’s 
the entire underlying Ubuntu 
Snappy Core operating system 
to play with. Nextcloud itself 
is installed as a ‘Snap,’ a self- 
contained collection of all the 
dependencies required to run the 
software. You’re free to install 
as many other Snaps as you like, 
adding extra features above 
and beyond what you’|I find in 
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the Nextcloud 

app store, with 

no fear of breaking 

or disrupting the 

Nextcloud Snap itself. 
Sadly, not everything with 


the Nextcloud Box is as smooth ——— 
as its software. The supplied 
Nextcloud-branded housing, one 
of several designs created by WD 
Labs, requires that the cables go 
through some tight bends before 
being routed out through gaps 

in the walls. The biggest flaw 

by far is the power cable for the 


Finish setup 


Above The 
Nextcloud box 
runs Ubuntu 


Pi; taking the form of a clever 
pass-through cable providing 
power to the hard drive as well, 
it exits the case only to turna 


fast word 


Powerful, flexible, and 


extremely configurable, 

full 180 degrees and go back in Nextcloud is a fantastic bit of 
again in order to reach the Pi’s software which runs perfectly 
micro-USB power socket. on the Raspberry Pi 2. Sadly, 

Providing you’re not constantly WD Labs’ contribution to the 
connecting and disconnecting project still needs a bit of 
the Nextcloud Box, though, it’s work, with the cabling inside 
largely a set-and-forget system: the box going through some 


install the cables, configure the worryingly sharp bends. 
software, and it’ll keep itself 

automatically updated through 
Ubuntu Core’s Snappy system. 
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Waker 
says 


Want to 


introduce 


kids to coding 
ina funand | 
creative way? 


No Starch Press 


LEARN TO 
CODE WITH 
SCRATCH 


We've got a lot 
of great stuff 

in our book 

for learning 
Scratch, along 
with a whole 
host of cool 
tutorials. 


Mag? 
LEARN TO 


SCRATCH CODING CARDS 


© 


| £4/86 
magpi.cc/ 
Scratch-book 


SCRATCH 
CODING CARDS 


Flash cards with Scratch code on to help kids learn and experiment 


e like Scratch here at 

The MagPi - it’s an 
amazing piece of software 
which is very easy to use, and it 
can create some truly astonishing 
projects. Perfect for helping 

kids learning to code to get to 
erips with the logic and language 
of programming. While we’ve 
definitely had tutorials in the 
magazine (and in a dedicated 
Scratch book!), we’re not the only 
place you can learn about Scratch. 
Meet Scratch Coding Cards. 

These flash cards provide a 
unique way to go about learning 
Scratch, presenting a concept or 
program (animating your name, 
creating a horse race) and then 
working you through step-by-step 
on how to build the project. Each 
project is colour-coded as well, 
so even if they do go everywhere, 
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you’ll be able to figure out how to 
reassemble the pack. 


The USP 


One of the most interesting 
things about the projects is that 
in some of them you don’t have 
to follow the prescribed order. 
Some of the programs have 

an end goal you’re working to 
create, but others just have you 
experimenting with code and 
Scratch. This is honestly one of 
the best ways to do it, as playing 
about with your code to see 
different results is a great way to 


test the limits of what you can do. 


Most importantly, parts of the 
code are explained as you make 
blocks, although we feel like they 
could go a bit more in-depth in 
some cases. There’s a size issue 
they have to work with, and 


admittedly young ones don’t want 
an essay on each function. At 
least they’re getting to use them 
in practice, which will help. 

Price-wise it’s interesting; it’s 
a premium product at least and 
the stock on the cards is very nice 
(when you make magazines you 
notice these things); however, 
the set might be a touch too 
expensive for what you’re getting. 
Still, it is a very good pack. 


fast word 


Possibly a little overpriced, 
and maybe it doesn't quite 
explain itself enough, but 


it should lead to hours of 
fun and a fairly thorough 
knowledge of Scratch. 
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Maker 
says 
Let your 

Raspberry Pi 

and camera 

look at 

the world 


ground you 
Pimoroni 


RASPBERRY 
P| CAMERA 
MOUNT 


It doesn't move, 
but if all you're 
after is a camera 
mount, you can 
pick one up 
from The Pi Hut 
for a tenth of 
the price. 


4 


£3 / $3.69 
magpi.cc/2hRtkdT 
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Painlessly 
Point a Pi e 
Camera 


PAN-IILT HAT 


Raspberry Pi camera stand with horizontal and vertical motion servos 


he Raspberry Pi Camera 
Module is one of the best 
accessories you Can get, 
enabling cheap photography on the 
Pi. But it doesn’t sit upright on its 
own ~— a Stand is required. 

The Pan-Tilt HAT fulfils this 
function and a whole lot more. 
The Camera Module is mounted 
on the end of a robotic arm that 
sits on top of the HAT. Thanks 
to the arm’s horizontal and 
vertical joints, the camera can 
be angled precisely by the two 
Servo motors. 

The finished effect is adorably 
cute, instantly imbuing your 
Raspberry Pi with personality 
as it looks around the room. 

It’s really useful too. You 
could set the Pan-Tilt HAT up 
to monitor a room, and then 
use VNC or SSH to adjust its 
viewing position remotely. 

Alternatively, you can set up a 
Raspberry Pi with face-tracking 
software and connect it to the 
Pan-Tilt HAT. Pimoroni, the HAT’s 
makers, also suggest mounting it 
on top of a robot for a set of eyes. 


Setting it up 
First, you have to set the HAT up. 
Fortunately, there is an online 
setup guide (magpi.cc/2hR4NFC). 
The board has a GPIO connection 
On one side, and servo connections 
on the other. The two sets of cables 
on the arm are connected to Servo 1 
and Servo 2 on the board (1 for pan, 
2 for tilt). A third servo channel 
can be used to control an optional 
NeoPixel strip for lighting. 


Camera control 

You can download all of the code 
from Pimoroni’s GitHub page 
(magpi.cc/2hRrjyo). You need to 
install the pantilthat module to 
access the controls. 

After importing the pantilthat 
library in Python, you use pan() 
and tilt() methods to change the 
camera position. These accept any 
value between -90 and 90. To set 
the camera straight forward, for 
example, you would use: 


pantilthat.pan(@) 
pantilthat.tilt(@) 


To look up by 45 degrees, use: 
pantilthat.tilt(-45) 


To look all the way to the 
camera’s left, you’d put: 


pantilthat.pan(90) 


We would have dearly loved more 
software examples. There are ones 
for motion and NeoPixels, but none 
for recording from the camera or 
face-tracking. A few more sample 
programs and it’d be perfect. 

Even so, we had a lot of fun 
setting up the Pan-Tilt HAT and 
look forward to researching and 
coding a face-tracking program. 


fast word 


A highly enjoyable and 
extremely cute accessory. 


With a bit of research, you 
should be able to create 
some fun things with it. 
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RASPIROBOT ROVER KIT 


Waker 
days 


Build your 
own Robot 
Rover for 
Raspberry Pi 
- just add 
Raspberry Pi 


and batteries 
Monk Makes 


RASPIROBOT 
ROVER KIT 


rod A kit that includes more than Just a robot, 
how well does it work for teaching youngsters about coding? 


ight WW e always like the kit Squid RGB LED. These work on is attached to the rear so it can 
i OTRCE from Monk Makes. It’s the RasPiRobot board without pootle about, and the battery pack 
fairly simple- functional, comes with it needing to be built as a robot; can be attached to the underside. 
eee great documentation and most however, it does also mean youcan The Pi is merely stuck to the 
TOO anibS importantly is always a good attach them once the robot is built. | surface using some Blu-Tack or 
programmed price. The RasPiRobot board that It’s an interesting concept as in double-sided tape and the rest 
ee you can currently buy scored theory youcanuse the buttonand ~— of the components slot neatly 
well in our review a little while LED as a ‘getting started with GPIO into the motor controller which 
ago, So it’s nice to see a kit that programming’ step andthen move attaches on top of the Pi. It’s 
uses it for a Pi robot in the way onto building the robot and doing very simple and there’s a couple 
Simon Monk intended. even more. of video guides from Simon that 
This particular robot kit is two As for the robot build itself, show you how to do it, although 
kits in one. As well as being able the process is nice and easy. The it would be nice to have a step- 
to create a basic robot that you chassis is made up of one piece of — by-step visual guide as well. It 
m can program, you have access to laser-cut acrylic and it uses two took us an episode of the original 
magpi.cc/2hA8f6i aa 
a push button and the Raspberry motors to drive it. A caster wheel Star Trek to build, so under an 
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Above There's not much to build with the 
kit and you'll be done very quickly. There 
are lots of extra parts, though 


hour, although that does include 
us struggling to peel off the 
protective layer of paper from the 
chassis and find the rechargeable 
batteries for it. 


it connected up to the board, 
although that’s all part of the fun. 
Programming it is very easy, 
using the same standard Monk 
Makes libraries. The instruction 


You can use the button and 
LED as a‘getting started with 
GPIO programming step 


Tough enough 

Once built it’s quite sturdy. The 
chassis isn’t large enough to be 
bendy and the Raspberry Pi can be 
affixed firmly enough in place so it 
doesn’t fly off. The kit also comes 
with speed sensors in the form of 
timer discs you can attach to the 
motors if you want to get the extra 
sensors to add them. Speaking of 
adding sensors, there are plenty 
of spots along the chassis to add 
them. The front is especially good 
for line and proximity sensors, 

as well as adding a pan-and-tilt 
arm. You’ll have to do the research 
yourself to figure out how to get 
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booklet that comes with the robot 
also provides some little tutorials 
on getting the LED and button 
working, as well as programming 
the robot for remote control 

and autonomy. The ultrasonic 
rangefinder also has a bit in there, 
so you Can Start programming 
with that as well. The great part 
about all these instructions is 
that you can combine them to do 
crazy things. For example, you 
could have the button start a little 
mission where it drives towards 
the nearest wall and uses the 
rangefinder data to change the 
colour of the LED as it gets closer. 


RASPIROBOT ROVER KIT 


While a minor spin on the normal 
robot kit, it does open up a lot 
more types of customisation and 
play options that are much simpler 
to understand. 

We very much like the 
RasPiRobot Rover and its kit. 
We’ve built a few other similar and 
simple robots and while they’ re 
always quite good, they don’t 
quite go the extra mile like this. 
Not only that, but we can easily 
eet our Raspberry Pi off it without 
having to fiddle around with tiny 
screws to do so. For the price, as 
well, it’s an excellent starter kit for 
kids interested in the Raspberry Pi 
and programming electronics. 


A wonderfully put together 
piece of kit, the RasPiRobot 


Rover is a great intro to 
robotics that can also be used 
far beyond the beginner level. 
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RASPBERRY PI 
BESTSELLERS 


Not just an IT book company, McGraw-Hill 
has the books to help you turn your 
project into a business. 


THE STARTUP 
EQUATION 


Authors: Steve Fisher, 
Ja-Nae Duane 

Publisher: McGraw-Hill 

Price: £27.99 

ISBN: 978-0071832366 

magpi.cc/2igcc1E 


Will your project or idea make 
you one of the ‘next billion 
entrepreneurs’ referred to by 
the authors? They give you 

all of the tools necessary ina 
detailed, yet nicely visual guide. 


WINNING THE 
BRAIN GAME 


Author: Matthew E May 
Publisher: McGraw-Hill 
Price: £16.99 

ISBN: 978-1259642395 
magpi.cc/2ig7lO3 


Learn to ‘Think Different’, 
and run rings around your 
competitors: your mind 

can overcome the seven 
fatal flaws of thinking using 
framestorming, jumpstarting, 
prototesting, and May's well- 
tested toolkit. 
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ONE PERFECT ee 


PITCH 


Author: Marie Perruchet 
Publisher: McGraw-Hill 
Price: £19.99 

ISBN: 978-0071837590 
magpi.cc/2ig5Sqx 


You know your solution is 
brilliant, elegant, and way 
ahead of the competition, 
but backers and customers q 
need to be engaged by more } 
than dry facts. Learn to tell 

your story. 
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INVENT YOUR OWN 


COMPUTER 
GAMES WITH 


PYTHON 


Author: Al Sweigart 


INVENT 
Publisher: No Starch compure ew 
ublisher: No Stare WIPUTER GAMES 


T 
Price: £23.99 3 
ISBN: 978-1593277956 
magpi.cc/2igb91v 


YTHON 


This is a very well- 
paced introduction ey 
to coding and L_R 
to Python 3, all 

done through games programming. 
Starting gently, but always thorough 
in its teaching approach, each game 
carefully introduces new concepts, 
from loops to working with lists. For 
example, in the Hangman game, 

the task is nicely broken down into 
separate tasks by flowchart, then 
composed into functions in the code, 
all nicely modular. Stepping through 
programs with the debugger, and 


MANAGE YOUR 


PROJECT 
PORTFOLI 


Author: Johanna Rothman 
Publisher: O'Reilly 


<@ _ formula for painlessly teaching 


entering breakpoints, is awelcome 
early chapter. 

Games make a great foundation, 
with early emphasis on user 
interaction, data structures, and even 
AI, as well as the motivation of ‘look 
what I’ve made; would you like a go°”. 

By the time the reader reaches 
Pygame in the last quarter of the 
book, she should have a firm grasp 
of some very important basics. 

After four editions (the previous 
three through CreateSpace), 
and a number of other titles, 
Sweigart is close to perfecting the 


what, one occasionally forgets, is 

actually quite difficult. Should work 
equally well with adult beginners, 
and with those in the Code Club 
age group, leaving them ready to 
tackle more in-depth programming 
texts. Fun and educational — our 
favourite combination. 


Score 


shield our teams from the clashing 
demands of (seemingly unthinking) 
management, this book offers 
not just snippets of wisdom, but a 
practical plan. Those snippets range 
from practical ways of bringing in 
Agile technologies to 
waterfall organisations, 
to a simple high-level 


Price: £28.99 Pro Pos 
ISBN: 978-1680501759 Second Edition ks view to show that you 


magpi.cc/2ig4LHA 


Never mind ‘those who 
can, do’, we find it’s 
‘those who can, take on 
far too much’. This is such 
a familiar pattern among makers 
and free and open source software 
programmers, as much as amongst 
IT teams of medium and large 
enterprises for whom this book is 
written, that we think that anyone 
feeling overwhelmed beneath a 
mountain of unfinished — and quite 
possibly unfinishable — projects will 
find some useful nuggets here, if 
not a whole plan of escape. 

For those of us who do work 
in larger organisations, trying to 


6 . 


Increase Your Cy 
Fini apacity 
h More Projects 


have no spare capacity, 
and plenty of relevant 
advice such as: “with 
enough multitasking, 
you can bring all work 
to a dead stop.” 

Drafting your portfolio and 
evaluating your projects, deciding 
which to commit to, making the 
decisions collaboratively — after 
all this, the last chapter is called 
‘Start Somewhere ... But Start’. 
This survival manual for the hard- 
pressed will decrease stress levels 
in numerous organisations. 


' 


Score 
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RASPBERRY 
PIIOT INC 


Author: Harry Fairhead 
Publisher: |/O Press 
Price: £14.85 

ISBN: 978-1871962468 
magpi.cc/2igfd22 


Get closer to the metal. 
Programming with C 


gives you the chance to Harty Fairhead Pinney my nea 


work directly with the 
hardware, bypassing Raspbian’s 
Linux drivers, for speed, custom 
features, and to understand the 
interfaces in the face of occasionally 
contradictory documentation. Harry 
Fairhead’s book eschews HATs in 
favour of off-the-shelf sensors, so 
that you can work directly with all 
of the Pi’s data buses. 

The bcm2835 library is used, but 
sometimes interfacing through 
Linux’s everything-is-a-file 
interface is suitable, and that is 
discussed; then implementing your 


COMPUTER 
SCIENCE 


Authors: Robert Sedgewick, 
Kevin Wayne 

Publisher: Addison-Wesley 

Price: £49.99 

ISBN: 978-0134076423 

magpi.cc/2igbocZ 


Sedgewick and Wayne 
of Algorithm (book and 
MOOC, see The MagPi #45) 

fame, give us an 1,168-page guide 

to computer science, with Java 
programming. It’s not just an 

intro to the science of computing, 
but is imbued throughout with a 
love of science, engineering, and 
mathematics — found particularly 

in many of the excellent example 
problems and exercises, which draw 
on equations and algorithms from 
all areas of STEM. 

This helps lift it above run-of- 
the-mill text books, and combines 
with clear-headed writing to make it 
a joy to follow along with. Structure 
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COMPUTER 


SCIENCE 


ROBRERY SE0GEWICK 
EVIN WarNe 


own version of sysfs is shown, for 
a speedier version of the Linux API. 
Only minimal parts are needed, 
but use of a logic analyser or 
oscilloscope lets you 
follow along when 
measuring the actual 
speed of change on the 
GPIO lines — interesting 
if you’re after close to 
real-time performance. 
After GPIO, the real- 
time scheduling problem, 
and generating musical 
notes, the PC bus is demystified, 
then an excellent section on the 
1-wire bus; after that, the SPI 
bus. Old-school serial interfaces 
are problematic, with the kernel 
seeing them as somewhere to log 
on from, and the Pi 3 using it for 
Bluetooth: various workarounds are 
discussed. Web and WiFi round off 
an invaluable guide. Recommended. 


Score 


is logical: from basics (variables, 
conditionals, arrays, etc.); functions; 
OO programming; algorithms 
and data structures; theory of 
computing; and then some 
practical elaborations 
vs7 on that. Along the way, 
multimedia is introduced 
early on, always in the 
service of interdisciplinary 
understanding, with 
Sierpinski triangles and 
Barnsley ferns asking ‘what 
does computation tell us 
about nature°’, and vice versa. 
Sounds like just an old-school 
alternative to those zany, cartoon- 
laden introductions to programming 
we all prefer nowadays? Well, 
there’s more. Each section features 
dozens of exercises which, should 
you work your way through all of 
them, will make you a better coder 
than many programmers of longer 
experience. Outstanding. 


vr 
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ESSENTIAL READING: 
CLASSIC SCI-FI 


Don’t be out-geeked! Catch up on these sci-fi 
classics, old and modern. 


Brave New World 


Author: Aldous Huxley 
Publisher: Vintage Classics 
Price: £8.99 

ISBN: 978-0099518471 
magpi.cc/2igbG3v 


Happiness without meaning. “A more 
astute guide to the future than any other 
20th century novelist,” says JG Ballard. 


Foundation trilogy 


Author: Isaac Asimov 
Publisher: Everyman tens 
Price: £13.99 Cc =) : 
: = faeenarion 
ISBN: 978-1841593326 scent rity 
magpi.cc/2ig87uUw . 


Now 70 years old, it remains stunning in 
its breadth of vision, and immediate in its 
individual versus collective narratives. 


Neuromancer 


Author: William Gibson 
Publisher: Gollancz 
Price: £8.99 

ISBN: 978-1473217386 
magpi.cc/2igjGld 


Noir reborn in a dystopian internet- 
saturated future. More than 30 years 
old, yet both familiar and futuristic. 


Do Androids Dream 
Of Electric Sheep? 


Author: Philip K Dick 
Publisher: Gollancz 
Price: £8.99 

ISBN: 978-0575079939 
magpi.cc/2igc3vb 


Filmed for its dark thriller elements 
as Blade Runner, the original is more 
reflective, and more disturbing in 

its questions. 


The Warrior's Apprentice 


Author: Lois McMaster Bujold 
Publisher: Baen 

Price: £10.99 

ISBN: 978-1476781303 
magpi.cc/2igff9S 


va Diss tla sella NOV 


ols 
McMASTER 
RUJOLD 


Warm-hearted, humorous; engineering, 
bio-tech, and classic war strategy; this 
ongoing series sets the standard for 
modern sci-fi. 
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CCT INTERVIEW 


APL 


» EDUCATING 
s WITH OLD CODE 


How a programming language last popular in the Eighties is making a comeback 


he oddly named A 
Programming Language 
(APL) isn’t exactly new. 
Invented in the 1960s, this 
language is somewhat different 

to Python and other classic 
languages like C. While it declined 
in popularity from the mid-1980s 


Hidden 


( 


a a oe. 
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Input 


PI BRAIN 


The concept of neural networking is using the brain 
as a model for processing data, which is something 
Romilly Cocking has been experimenting on for 
years with APL. 

“Back in 1984 as part of my LSC, | did a simulation 
which burnt up pretty much up all the department's 
usage of computing power in a week trying to 
simulate a terribly cut-down model of part of 
the brain called the cerebellum,” says Romilly. 
“These days, something that’s about a million 
times larger, in terms of number of nerve cells, 
runs happily on a Pi. It's allowed me to carry on the 
research | started in 1984.” 
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on, in the last few years it has been 
making a comeback, including a 
CSTE BONE 0) LE Nels) preinyy Pi, 
“It’s a Slightly curious language 
because it’s called A Programming 
Language, but it was created 
by a mathematician,” Morten 
Kromberg tells us. Morten is 
the chief experience director at 
Dyalog, a company that specialises 
in APL-based solutions, and the 
force behind APL’s resurgence. 
“APL in [its creator’s] mind 
was trying to be mathematical... 
most of the people using 
computers in the early years 
had some other background — 
software engineering hadn’t 
Sein iain eral ele ein ame /MIlh 
software in that period was 
hand-made, so APL was a more 
comfortable fit for many of these 
people than the languages being 
invented. It was very widely used 
on mainframe computers and 


then there was what we think 

of as the dark age where the 
focus of software engineering 
became very structured, with 

a lot of effort being spent on GUI 
frameworks and stuff like that, 
which was really quite daunting 
and off-putting for many of the 
people who were trying to use 

it to solve problems.” 

Now that platforms are 
becoming more friendly, he feels 
like APL is more relevant than 
it has ever been. 


Educational APL 


A few years ago, APL was ported to 
Raspbian, following on from ports 
to Windows, Mac, and other Linux 
systems. Dyalog thinks APL has a 
distinct advantage in many areas 
Ove Ollemeode: 

“As far as I’m concerned I 
think the education applications 
where APL on the Pi would work 
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") MiServer Demo 
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MiServer 
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Anyone who can write an APL function should be able to host it on the web.™ 


My First PiCam App 


Drive for 0.7 seconds. 


0k] [Nah [Auto 


Manual Controls 


[Forward] 


Left | | Right | 


——s 


The robot programmed with Dyalog 
APL is well loved by the team 


really well are a sweet spot where 
three things combine,” Romilly 
Cocking, an APL veteran, reveals. 
“Firstly, if you’re tackling a 
problem [that] you don’t initially 
know how to solve, you are 
exploring and testing. Secondly, 
that problem involves fairly 
complex algorithms. Thirdly, 
performance matters. Probably 
because you’ve got a lot of data, 
or possibly just because you’ re 
trying to build a robot and the 


It's called A Programmiung 
Language, but 1t was created. 
by amathematician 


robot needs to react very quickly. 
In any problem that satisfies 
those three things, APL would 
be both a good thing and a fun 
thing to use.” 

Though UK schools may 
not have taken APL to heart 
yet, it has been successful in 
education elsewhere, as Vibeke 
Ulmann, PR representative for 
Dyalog, explains. “For the past 
two years, although they have 
not been using the Raspberry P1, 
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Introduction to MiServer 


an Italian class of students aged 
about 14 and 15 have been using 
APL for mathematics teaching. 
They’ ve done some absolutely 
stupendous presentations 
about how they understood the 
language and how they came to 
understand [it]... Using the Pi for 
mathematical work in a school 
environment would, I think, be 
quite fun.” 

You can watch a video about it 
online here: magpi.cc/2hzwmCe. 


Work is still being done on APL 
on the Raspberry Pi, with future 
plans to incorporate OpenCV and 
the Camera Module. It’s also very 
good for parallel computing, with 
other plans to implement clusters 
with APL for some excellent (and 
cheap) number crunching on the 
Raspberry Pi. Dyalog is hoping 
all of this will create a new 
generation of APL users ready 
to improve and work with the 
venerable language. 


ONE OF THE PROJECTS MORTEN AND 
ROMILLY HAVE WORKED ON WITH APLIS 


AN APL-PROGRAMMED, PI-POWERED ROBOT 


2. 


February 2017 MagPi 
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Community 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


GEARING UP 


“201 


86 


team aren’t resting on their laurels yet. 
Pi Foundation CEO Philip Colligan detailed the 


plans for Raspberry Pi in 2017 in a blog on the 
website (you can read it here: magpi.cc/2ijU9rn). 
In it he talked about all the amazing things that 


happened just in 2016: 


“By any measure, the Raspberry Pi Foundation 
had a fantastic 2016. We ended the year with over 
11 million Raspberry Pi computers sold, millions 
of people using our learning resources, almost 


1,000 Certified Educators in the UK and US, 


75,000 children regularly attending over 5,000 
Code Clubs in the UK, hundreds of Raspberry 


his year the Raspberry Pi will be five years 
old. It’s been a great few years for the little 
computer, but the Raspberry Pi Foundation 


Jams taking place all over the world, code written 
by schoolkids running in space (yes, space), and 
much, much more.” 
Here are some of the exciting things Philip talked 
about that are in store for Raspberry Pi in 2017: 


ES) hs 


FREE EDUCATIONAL 
RESOURCES 


There are already loads of free 
online tutorials and lesson plans 
for learning to code with the 
Raspberry Pi, and many more will 
be coming in 2017. Raspberry Pi 
will also release a digital making 
curriculum (possibly by the time 
you read this) to help aid educators 
structure learning. There's also 

a lot of video in the works... 
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LIGHTS OUT! 


THE SCRATCH OLYMPICS - 
WEIGHTLIFTER 


WINDOW ON THE WEATHER 


WHOOP! CUSHION 


MOCRO:BIT SELFIES 


oc - 


PEOPLE IN SPACE INDICATOR 


SCARY SPOT THE DIFFEREN! 


SENSE HAT MARBLE MAZE 


YOUNG DIGITAL MAKERS 
Getting young people into computing has always 
been a big goal of the Raspberry Pi Foundation, 
and more is coming in 2017 to aid this. Code Clubs 
are opening up around the world and a brand new 
competition called Pioneers has launched to get 
teens excited about making. 


' PICADEMY | 
USA. 7 


COMMUNITY 

The community is extremely important to Raspberry 
Pi - it’s one of the selling points of the hardware, to 
be quite honest. The Foundation will be increasing 
its outreach in the UK, and setting itself up as a 
charity in the US to help do more there. 


EDUCATORS 

As well as continuing to certify educators through 
Picademy courses, a brand new series of free online 
courses is available, with more to come. Check out our 
news section for more details. 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out.. 


TCT Tea 
ni ) ] = 


There are a few audio cards for the Raspberry Pi, but 
we’ve never seen anything quite like this. The Audio 
Injector team have put together a surround sound 
HAT for the Pi with both inputs and outputs using RCA 
so that you can add surround sound to your projects. 
We'd like to see it attached to a Pi running some form 
of Kodi, but we assume it will be more practical for 
interesting audio projects in the short term. 
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You may have heard of Farm Pi, the farming robot for 
communities, but the SmartPlantPi is a much more 
scaled-down affair that keeps an eye on your house 
plant. We love that the pictures on the Kickstarter have 
a little picket fence around the plants. Anyway, it waters 
your plant and monitors several other environmental 
factors. No need to get your neighbours to water your 
plants when you’re away, then! 
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A visit 

to the BBC was on 
the cards, thanks 

to the Make it 
Digital campaign 
Femi continues 

to run workshops for 
others, improving 
on his worksheets 
for events such as 
MozFest, PyCon, and 
Raspberry Jams 
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Hacker Femi and his Certified Educator mum 
Grace rock the South London Jam scene 


race Owolade-Coombes 

heard about coding 

through her work in 
further education and found 
herself intrigued. Mother toa 
‘young, inquisitive son’, she felt 
the urge to investigate further. 
However, it wasn’t untila 
year later, while attending the 
National STEM Centre in York, 
that she finally discovered more 
about coding and what the term 
actually meant. 

She was sent in the direction of 
the Raspberry Pi Foundation and 
attended a few events with her 
son, Femi, where they discovered 
the warmth of the community and 
the fun to be had with projects 
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such as Minecraft hacks and 
robot builds. From there, Grace 
found herself on the Picademy 
programme and, after the two- 
day course, she felt excited and 
eager to get more involved in the 
community. “I particularly loved 
the physical coding workshop 
which I took back and delivered to 
my son, who also loved it.” 

With no prior background 
in computing, Grace, along 
with Femi, was able to take her 
Picademy experience and runa 
workshop at Covent Garden’s 
Dragon Hall - the first of many 
workshops the pair would lead. 

ANE a2 mine, Cin Wil Serene 
2015, Femi wrote on his website: 
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FEM! AND GRACE OWOLADE-COOMBES 
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In June, along with 
fellow Raspberry Pi 
community member 
Jonathan Tyler- 
Moore, Femi won 
the NanoSat Hack at 
Microsoft AzureCraft 


“x 


“This is my very first blog and Above Femi is forever building on his skill set; 


I’m getting ready to do a talk at 
CamJam in the morning.” He later 
went on to describe his experience 
at Festival of Code, an event 

he attended the summer after 
their first workshop at Dragon 
Hall. Femi is very open about 

his experiences with Tourette’s 
syndrome, a condition he was 
diagnosed with around the time of 


It was a great Success, 
leading to a Code Club and 
a further Raspberry Jam 


his introduction to the Raspberry 
Picommunity. While attending a 
Tourettes Action support group, he 
wanted to share his new passions 
with fellow group members. It 

was this desire to create a safe, 
comfortable place for his friends to 
learn that brought about the South 
London Raspberry Jam movement. 
“He asked if we could set up a 

jam that was inclusive - both 
autism and Tourette’s syndrome 
friendly. There was such a wealth 
of support, advice, and volunteers 
who would help us set up... it 
really wasn’t a hard decision to 
make.” The pair ran an Indiegogo 
campaign to raise money, 

hitting 241% of their target, and 
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from robots to radios, Minecraft, and Python, 
he loves discovering new ideas 


the event ran in October 2015, 
welcoming ages 5 to 15. It wasa 
ereat success, leading to a code 
club and a further Jam. By their 
third Jam, Femi and Grace were 
working in conjunction with 
various makers and producers, 
introducing attendees to Crumble 


inventor Joseph Birkes and Paul 
Hayes from Unity, all from within 
the Kano HQ. 

Femi continues to document 
his journey through his site, 
hackerfemo.com, relating 
his experiences as botha 
student and teacher within the 
community. Heading into 2017, 
the South London Raspberry Jam 
aims to expand into South London 
Makerspace. Meanwhile, Femi has 
been invited join the University 
of the Arts London Digital Makers 
Collective and asked to lead robot 
workshops at the Tate Modern, 
while also looking forward to 
taking part in both the European 
Astro Pi Challenge and Pi Wars. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 


themed events are happening near you... 


PALM SPRINGS 
HAMFEST 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 

ben@raspberrypi.org 


PALM SPRINGS HAMFEST 

When: Saturday 4 February 

Where: Palm Springs Air Museum, 
Palm Springs, CA, USA 

palmspringshamfest.com 

A demo of the Astro Pi will be 

held at Hamfest, one of the 

largest gathering of ham radio 

enthusiasts in California. 


AY JACKSON SCHOOL 

RASPBERRY JAM 

When: Sunday 11 February 

Where: AY Jackson SS Library, 
Toronto, ON, Canada 

magpi.cc/2hE6ghB 

An event for you to share and 

learn about the Raspberry Pi and 

computer engineering concepts. 
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RASPBERRY JAM: 

BITESIZE 

When: Saturday 18 February 

Where: Leamington Library Royal, 
Royal Leamington Spa, UK 

magpi.cc/2hPVqml 

A stripped-back Jam where 

you can get more help than 

you would at a standard Jam. 


RASPBERRY PI BIG 

BIRTHDAY WEEKEND 

When: Saturday 4 March 

Where: Cambridge Junction, 
Cambridge, UK 

magpi.cc/2hEjDyh 

Robots, gaming, animations, and 

much more at Raspberry Pi and 

Code Club’s 5th birthday! 


AY JACKSON < aah, 
RASPBERRY JAM 4 » a 


IANS ISILNG Ist Tel) lee INILS REGULAR EVENTS 


LEEDS RASPBERRY JAM 
When: Wednesday 1 February 
Where: Swallow Hill Community 
College, Leeds, UK 
magpi.cc/2hDzJYS 
There’ 11 be chances to get 
hands-on with more digital 
making activities through 
workshops anda hackspace. 


RASPBERRY JAM 

@ PI TOWERS 

When: Saturday 11 February 

Where: 30 Station Road, 
Cambridge, UK 

magpi.cc/2hDILoz 

Come and visit the Raspberry Pi 

Foundation’s headquarters and 

take part in a Jam like no other. 
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JAMS 
EVERYWHERE! 


RASPBERRY PI BIG 
BIRTHDAY WEEKEND 
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RASPBERRY JAM: 
BITESIZE 


STAFFORD 
RASPBERRY JAM 
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v MALVERN 
RASPBERRY JAM 


MALVERN 

RASPBERRY JAM 

When: Wednesday 15 February 

Where: Wyche Innovation Centre, 
Malvern, UK 

magpi.cc/2hEb8D8 

An opportunity to come along with 

your own Raspberry Pi to show 

people what you have been up to. 


FILL IN THE GAPS! 


THE ISLE OF WIGHT NEEDS JAMS 


The Isle of Wight is a lovely 
place and while it's small, 
plenty of people live there. It's 
also not always convenient 

to get to the mainland, and 
while Lucy Rogers does run the 
occassional Pi Wight event, 
more could go on for young 
folk on the island. If you fancy 
Starting your own Jam on the 
Isle of Wight, you can get more 
info from the Raspberry Pi site: 


The current Isle of 
Wight Jams have some 
prehistoric attendees 


STAFFORD 

RASPBERRY JAM 

When: Tuesday 14 February 

Where: The Signpost Centre, 
Stafford, UK 

magpi.cc/2hEjiva 

A big meetup of Pi enthusiasts who 
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love wosnare ideas, eli cach orien, 
and have a lot of fun! 
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F The MagPi . 


( Repositories 


pe: All + Lanquage: All 


magpi-issue52 


Ory: ¥ 


magpi-issue53 
@Python * 
From now on, every issue will 


magpi-issue51 have all its code uploaded to 


our website and GitHub repo 
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Resolve to change 

I really enjoyed the New Year’s resolutions article 
you did last year. In fact, I tried out a couple of them 
myself. I managed to lose a bit of weight! Hopefully 
I don’t put it all back on over Christmas. I was 
wondering if you were planning another New Year’s 
article for this year as well: 

Laura B 
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Christmas cover 

Thanks for the wonderful Christmas cover last issue 
[#52]! I really loved the idea of the official Raspberry 
Pi magazine being officially interactive with the 
Raspberry Pi in some way. I bought a second copy and 
wired it all up and it sits proudly among some of my 
other decorations. I did still put up a tree next to it; I 
hope you don’t object. Maybe I’1l upgrade it with the 
NeoPixel lights in the future. 

Will you be doing more of these styles of covers in 
the future? Maybe an Easter one with an egg hunting 
game, or something with the next Pi release! 
Anyway, I’m going to preserve the magazine with 
the rest of my decorations and use it next year as 
well. Thanks a lot! 

Phil Brown 


We’re glad you enjoyed it; it was a pleasure to put 
it together! We hope more people made the cover 
into their latest decoration as well (email or tweet us 
if you did!). You can also be sure that we’l] definitely 
try to do something like it again in the future, 
although we don’t 
want to spoil any 
plans we have. 

You should try 
out the NeoPixel 
lights if you havea 
chance next year — 
we might even adda 
few more functions 
into the code in 
our GitHub repo 
(magpi.cc/2juNw4J), 
so take a look if you 
do decide to make it. 


We hope to do 2ME WAITEN By mac x Te - 
more themed covers in Ty HMA i 
2017 - watch this space! aD 


We’re definitely not averse to seasonal themes, 
as you can probably tell by our Christmas issue. 
Unfortunately, though, we don’t have a New Year’s 
article this year. Instead, maybe you can treat the 
programming guide from issue 53 as your New Year’s 
resolution and start to learn to code? 

We'll keep it in mind for next year, though, and 
maybe we’1l do another New Year’s article in the mag! 
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FROM THE FORUM| ©: 22e2 ooking inte itas an option to get the 


magazine out to the US faster and more cheaply, 
but that’s probably not going to happen in the short 
term. Long story short, it’s very complicated, which 
is not hard to imagine. 

For the short term, though, what you can always 
do is actually print out the magazine. Remember, 
each issue is licensed under Creative Commons so 
you’re allowed to go to a good printers and get it 
printed out for yourself. 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 


for the community - join in via Otherwise, the subscription does work out a 
raspberrypi.org/forums lot cheaper than both these options, and you get 
a free Pi Zero as well. Check out magpi.cc/Subs1 
would love to have paper copies of The for more info. 


MagPi, but my local retailers want close to 

$20+ for copies. Has there been any talk 
of a printing company in the USA printing copies 
and stocking them locally for a cheaper price? 
kryptalivian 
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PROJECT 


with WD PiDrive Foundation Edition 


Create Raspberry Pi projects using the WD PiDrive Foundation 
Edition device with our custom NOOBs for a simpler onboarding 
experience, and Project Spaces for quick and easy access to your 
projects from one Raspberry Pi setup. 


erry 
£4 


Choose the version that's right for you: 


es 


WD PIDRIVE FOUNDATION EDITION 


Includes MicroSD™ Card 
$18.99 


WD PIDRIVE FOUNDATION EDITION 


USB HARD DRIVE 
250GB / 375GB = ; 
Includes MicroSD™ Card and WD PiDrive Cable s WD LABS 


$28.99 / $37.49 


wdlabs.wd.com/magpi54b 


Western Digital, WD, the WD logo; WDLabs-and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S; 


and/or other countries, Raspberry Pi is a trademark of the Raspberry Pi Foundation, microSD is a trademark of SD-3C, LLC, All other: marks are the property of their 
respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating environment. Product 
specifications subject to change without notice. Pictures shown may. vary from actual product. © 2017 Western Digital Corporation or its affiliates 


Tell us by 27 February Simply email competition@raspberrypi.org 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes on 27 February 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 


It))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR 
sonic Pi 


We work with all the major music solutions to ensure compatibility 


eee VOLUMIO (OC) «aArchphile JL kopl 


audio player ; : 
ne PiMusicBox 


Twitter: @IQ_audio 


lQaudio Limited, 
Email: info@iqaudio.com a U e C) Cricklade Wiltshire. 
Web: www.iqaudio.com Company No.: 9461908 
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PiSTORMS-V2 


Make Stunning Robots with 
LEGOs and Raspberry Pi | 


Column | THE FINAL WORD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


PLIFELONG 
» LEARNING 


Matt Richardson on how education with computers 
should continue well into adulthood 


hen you contemplate the Raspberry Pi 
Foundation’s educational mission, you 
might first think of young people learning 
how to code, how computers work, and how to make 
things with computers. You might also think of 
teachers leveraging our free resources and training 
in order to bring digital making to their students in 
the classroom. Getting young people excited about 
computing and digital making is an enormous part of 
what we’re all about. 

We all know that learning doesn’t only happen in 
the classroom — it also happens in the home, and at 
libraries, code clubs, museums, scout troop meetings, 
and after-school enrichment centres. At the 
Raspberry Pi Foundation, we acknowledge that and 
try hard to get young people learning about computer 
science and digital making in all of these contexts. 
It’s the reason why many of our Raspberry Pi Certified 
Educators aren’t necessarily classroom teachers, 
but also educate in other environments. 

Even though inspiring and educating young people 
in and out of the classroom is a huge part of what 
we set out to do, our mission doesn’t limit us to only 
those that are young. Learning can happen at any 
age and of course we love to see kids and adults using 
Raspberry Pi computers and our learning resources. 
Although our priority is educating young people, we 
know that we have a strong community of adults who 
make, learn, and experiment with Raspberry Pi. 

I consider myself among this community of lifelong 
learners. Ever since I first tried Raspberry Pi in 2012, 
I’ve learned so much with this affordable computer 
by making things with it. | may not have set out to 
learn more about programming and algorithms, but 
learned them as a by-product of trying to create an 
interesting project that required them. This goes 
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beyond computing, too. For instance, I needed to 

give myself a quick maths refresher when working 

on my Dynamic Bike Headlight project. I had to get 
the speed of my bike in miles per hour knowing the 
radius of the wheel and the revolutions per minute 
from a sensor. I suspect that - like me - a lot of adults 
out there using Raspberry Pi for their home and work 
projects are learning a lot along the way. 


Internet of Tutorials 

Even if you’re following a tutorial to build a retro 
arcade machine, set up a home Server, or create a 
magic mirror, then you’re learning. There are tons of 
ereat tutorials out there that don’t just tell you what 
to type in but also explain what you’ re doing and why 
you’ re doing it at each step along the way. Hopefully it 
also leaves room for a maker to experiment and learn. 

Many people also learn with Raspberry Pi when they 
use it as a platform for experimental computing. This 
experimentation can come from personal curiosity or 
from a professional need. 

They may want to set up a sandbox to test out things 
such as networking, servers, cluster computing, or 
containers. Raspberry Pi makes a good platform for 
this because of its affordability and its universality. 
In other words, Raspberry Pis have become so 
common in the world that there’s usually someone 
out there who has at least attempted to figure out 
how to do what you’re looking for with it. 

To take it back to the young people, it’s critical 
to show them that we, as adults, aren’t always 
teachers. Sometimes we’re learning right beside 
them. Sometimes we’re even learning from them. 
Instil in them the idea that learning doesn’t stop 
after they graduate. We must show young people 
that none of us stops learning. 
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ESSENTIALS 
LEARN | CODE | MAKE 


OUT NOW IN PRINT 
ONLY £4/$6 
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GoPiGo 


Raspberry Pi + LEGO MINDSTORMS 


$99.99 USD-$199.99 USD 


serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PF! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditferential P 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 1O Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire PI Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 


™ 


Cana 


The Perfect Holiday Gift! 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic Circuits 


Raspberry Pi board and Case 
Sine Supply and HDMI Cable 
re-Programmed M 
emory Ca 
Over 40 electronic nee - 


Available for worldwide shipping at: 
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Available in Europe 
through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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